Системные требования — AiHummer Документация

AiHummer — host-native продукт: он работает как релизный tarball под управлением systemd, поэтому требования намеренно скромные. Единственная жёсткая зависимость — хост на Linux с PostgreSQL. Всё остальное — сайдкары, реальная модель, векторное хранилище — опционально и добавляется позже из админки.

[!NOTE] AiHummer работает host-native, а не в Docker. Он разворачивается как tarball под systemd из ~/.aihummer (домашняя директория пользователя, запустившего установщик). Не нужны ни рантайм контейнеров, ни Kubernetes, ни какой-либо оркестратор.

Операционная система

AiHummer работает только на Linux. Серверной сборки под Windows или macOS нет — gateway и его сайдкары поставляются как Linux-артефакты под каждую архитектуру и разворачиваются через systemd. (Клиент — это отдельное мобильное и десктоп приложение; это канал, а не сервер.)

Современный 64-битный дистрибутив Linux с systemd.
x86_64 (amd64) или arm64 — установщик скачает бандл под нужную архитектуру.
Доступ sudo/root не обязателен строго: обычная установка идёт через sudo, но установщик, запущенный без root, ставит AiHummer в rootless-режиме под systemd --user — см. Установку.

База данных

PostgreSQL — единственная жёсткая зависимость и единый источник истины для всего состояния. Расширение pgcrypto обязательно — на нём держится зашифрованный vault доступов. Без базы данных gateway стартует в урезанном режиме health-only и не делает ничего полезного.

[!IMPORTANT] Включите pgcrypto в целевой базе до первого запуска:
CREATE EXTENSION IF NOT EXISTS pgcrypto;

Gateway подключается по DSN из AIHUMMER_DATABASE_URL. Для изоляции арендаторов можно дополнительно указать AIHUMMER_DB_APP_URL на ограниченную роль aihummer_app, чтобы активировать Postgres Row-Level Security; локальные установки настраивают это автоматически. Миграции БД безопасны вперёд и применяются автоматически под advisory-локом на owner-пуле.

Аппаратные требования

Эти значения — ориентир для развёртывания gateway плюс PostgreSQL на одном хосте. Сайдкары (STT/TTS, браузер, векторное хранилище) добавляют свой расход ресурсов и обычно размещаются на том же хосте только для небольших инсталляций.

Профиль	CPU	RAM	Диск	Примечания
Минимум (оценка)	2 vCPU	2 ГБ	10 ГБ	Gateway + Postgres, mock-модель, без сайдкаров
Рекомендуется	4 vCPU	8 ГБ	40 ГБ SSD	Gateway + Postgres + пара сайдкаров
Голос / локальные модели	8+ vCPU (GPU опц.)	16+ ГБ	80+ ГБ SSD	STT/TTS, эмбеддер, локальный LLM-эндпоинт

Расход диска растёт с историей переписок, директорией медиа-блобов (AIHUMMER_BLOB_DIR), индексацией знаний и сроком хранения аудита. Планируйте резервные копии PostgreSQL (pg_dump + WAL/PITR) соответственно.

Сайдкары (опционально)

Сайдкары — это отдельные HTTP-сервисы, каждый под своим systemd-юнитом. Gateway обращается к ним по URL, поэтому сайдкар может работать на том же хосте, на другом хосте, или можно указать на уже существующий инстанс. Все они свободные/локальные и никогда не обязательны для базового развёртывания.

Сайдкар	Порт по умолчанию	Что включает
STT (faster-whisper)	8001	Распознавание речи для голосовых ходов
TTS (edge-tts)	8002	Синтез речи для голосовых ходов
Video (ffmpeg)	8005	Понимание видео
SearXNG	8888	Инструмент `web_search`
Chrome/CDP	9222	Инструменты `browser` / `computer`

STT, TTS и video ставятся установщиком из коробки (отключаются переменными AIHUMMER_SKIP_*). Семантический эмбеддер — opt-in (--with-embedder): он тянет PyTorch (сотни МБ), а без него память работает на лексическом fallback-поиске. Остальные сайдкары установщик может развернуть нативно, либо вы можете подключить существующий по URL — см. Установку.

LLM-провайдеры

AiHummer никогда не требует платной модели. Из коробки он работает на свободных/локальных моделях и транспорте через подписку Codex/ChatGPT; ключи BYOK на арендатора строго опциональны.

Поддерживаемые провайдеры:

Anthropic.
OpenAI.
Любой эндпоинт по стандарту OpenAI API — например, локальные серверы моделей, OpenRouter или OpenAI-совместимый эндпоинт Gemini.
Транспорт через подписку Codex / ChatGPT — управление моделью через подписку ChatGPT вместо тарифицируемого API-ключа.

[!TIP] Если запустить gateway без подключённой модели (AIHUMMER_LLM_PROVIDER / AIHUMMER_LLM_MODEL / AIHUMMER_LLM_GATEWAY_URL), ответы приходят из детерминированного mock, так что вы можете проверить каналы и роутинг ещё до подключения реальной модели.

[!NOTE] AiHummer предоставляет только OpenAI-совместимый эндпоинт POST /v1/chat/completions. Эндпоинтов /v1/models или /v1/embeddings нет, а наблюдаемость работает по push-модели OTLP (без Prometheus /metrics).

Куда дальше

Готовы разворачивать? Перейдите к Установке.
Хотите пройти первый запуск по шагам? См. Квикстарт.
Сначала хотите понять модель? Прочитайте Введение.