Сістэмныя патрабаванні — AiHummer Дакументацыя

AiHummer — гэта host-native прадукт: ён працуе як рэлізны tarball пад systemd, таму патрабаванні наўмысна невялікія. Адзіная жорсткая залежнасць — гэта хост Linux з PostgreSQL. Усё астатняе — sidecar’ы, рэальная мадэль, вектарнае сховішча — апцыянальнае і можа быць дададзена пазней з адмінскага UI.

[!NOTE] AiHummer — host-native, не Docker. Ён разгортваецца як tarball, што працуе пад systemd з /home/.aihummer. Вам не патрэбны кантэйнерны рантайм, Kubernetes ці які-небудзь аркестратар.

Аперацыйная сістэма

AiHummer працуе толькі на Linux. Няма сервернай зборкі для Windows ці macOS — gateway і яго sidecar’ы запакаваны як артэфакты Linux для адпаведнай архітэктуры і разгортваюцца з systemd. (Кліент — гэта асобнае мабільнае і дэсктопнае прыкладанне; гэта канал, а не сервер.)

Сучасны 64-бітны дыстрыбутыў Linux з systemd.
x86_64 (amd64) ці arm64 — усталёўшчык выцягвае адпаведны пакет для архітэктуры.
sudo/root доступ для запісу кораня ўсталёўкі і рэгістрацыі юнітаў systemd.

База даных

PostgreSQL — гэта адзіная жорсткая залежнасць і адзіная крыніца праўды для ўсяго стану. Пашырэнне pgcrypto абавязковае — яно падтрымлівае зашыфраванае сховішча ўліковых даных. Без базы даных gateway запускаецца ў скарочаным рэжыме толькі здароўя і не абслугоўвае нічога карыснага.

[!IMPORTANT] Уключыце pgcrypto ў мэтавай базе даных перад першым запускам:
CREATE EXTENSION IF NOT EXISTS pgcrypto;

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

Апаратнае забеспячэнне

Гэтыя лічбы — кіраўніцтва для разгортвання gateway плюс PostgreSQL на адным хасце. Sidecar’ы (STT/TTS, браўзер, вектарнае сховішча) дадаюць свой уласны след і звычайна размяшчаюцца на тым жа хасце толькі для невялікіх разгортванняў.

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

Выкарыстанне дыска расце з гісторыяй размоў, дырэкторыяй медыя-блобаў (AIHUMMER_BLOB_DIR), прыёмам ведаў і захаваннем аўдыту. Адпаведна плануйце рэзервовыя копіі PostgreSQL (pg_dump + WAL/PITR).

Sidecar’ы (апцыянальна)

Sidecar’ы — гэта асобныя HTTP-сэрвісы, кожны пад сваім уласным юнітам systemd. Gateway дасягае іх па URL, таму sidecar можа працаваць на тым жа хасце, на іншым хасце, або вы можаце накіраваць на існуючы экзэмпляр. Усе яны бясплатныя/лакальныя і ніколі не патрабуюцца для базавага разгортвання.

Sidecar	Порт па змаўчанні	Уключае
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`

Усталёўшчык можа забяспечыць sidecar’ы натыўна, або вы можаце падключыць існуючы па 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. Няма HTTP-канчатковага пункта /v1/models ці /v1/embeddings, а назіральнасць — гэта OTLP-push (без Prometheus /metrics).

Куды далей

Гатовы разгортваць? Перайдзіце да Усталёўкі.
Хочаце прайсці першы запуск крок за крокам? Глядзіце Хуткі старт.
Хочаце спачатку ментальную мадэль? Прачытайце Уводзіны.