AiHummer Системные требования
AiHummer — host-native продукт: он работает как релизный tarball под управлением systemd, поэтому требования намеренно скромные. Единственная жёсткая зависимость — хост на Linux с PostgreSQL. Всё остальное — сайдкары, реальная модель, векторное хранилище — опционально и добавляется позже из админки.
[!NOTE] AiHummer работает host-native, а не в Docker. Он разворачивается как tarball под systemd из
/home/.aihummer. Не нужны ни рантайм контейнеров, ни Kubernetes, ни какой-либо оркестратор.
Операционная система
AiHummer работает только на Linux. Серверной сборки под Windows или macOS нет — gateway и его сайдкары поставляются как Linux-артефакты под каждую архитектуру и разворачиваются через systemd. (Мобильный клиент — это отдельное приложение для iOS; это канал, а не сервер.)
- Современный 64-битный дистрибутив Linux с
systemd. x86_64(amd64) илиarm64— установщик скачает бандл под нужную архитектуру.- Доступ
sudo/root для записи в корень установки и регистрации systemd-юнитов.
База данных
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 | Синтез речи для голосовых ходов |
| Diarize (pyannote) | 8003 | Диаризация дикторов |
| Voiceclone (OpenVoice V2) | 8004 | Клонирование голоса |
| Video (ffmpeg) | 8005 | Понимание видео |
| SearXNG | 8888 | Инструмент web_search |
| Chrome/CDP | 9222 | Инструменты browser / computer |
Установщик может развернуть сайдкары нативно, либо вы можете подключить существующий по 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).