Жүйелік талаптар — AiHummer Құжаттама

AiHummer — хост-нативті өнім: ол systemd астында релиз tarball ретінде жұмыс істейді, сондықтан талаптар әдейі шағын. Жалғыз қатаң тәуелділік — PostgreSQL бар Linux хост. Қалғанының бәрі — sidecar-лар, нақты модель, вектор қоймасы — қосымша және кейінірек әкімші интерфейсінен қосылуы мүмкін.

[!NOTE] AiHummer хост-нативті, Docker емес. Ол /home/.aihummer ішінен systemd астында жұмыс істейтін tarball ретінде орналастырылады. Сізге контейнер ортасы, Kubernetes немесе кез келген оркестратор қажет емес.

Операциялық жүйе

AiHummer тек Linux-та жұмыс істейді. Windows немесе macOS сервер құрылымы жоқ — шлюз және оның sidecar-лары әр архитектураға арналған Linux артефактілері ретінде оралады және systemd-пен орналастырылады. (Клиент — бұл бөлек мобильді әрі үстелдік қолданба; ол — арна, сервер емес.)

systemd бар заманауи 64 биттік Linux дистрибутиві.
x86_64 (amd64) немесе arm64 — орнатушы сәйкес келетін архитектура бумасын тартады.
Орнату түбірін жазу және systemd бірліктерін тіркеу үшін sudo/root рұқсаты.

Дерекқор

PostgreSQL — жалғыз қатаң тәуелділік және барлық күй үшін жалғыз ақиқат көзі. pgcrypto кеңейтімі талап етіледі — ол шифрланған тіркелгі деректер қоймасын қамтамасыз етеді. Дерекқорсыз шлюз қысқартылған тек денсаулық режимінде іске қосылады және пайдалы ештеңе ұсынбайды.

[!IMPORTANT] Алғашқы іске қосудан бұрын мақсатты дерекқорда pgcrypto-ны қосыңыз:
CREATE EXTENSION IF NOT EXISTS pgcrypto;

Шлюз AIHUMMER_DATABASE_URL ішіндегі DSN арқылы қосылады. Көп жалгерлі оқшаулау үшін қосымша Postgres Row-Level Security-ді белсендіру мақсатында AIHUMMER_DB_APP_URL-ды шектелген aihummer_app рөліне бағыттай аласыз; жергілікті орнатулар мұны автоматты түрде орнатады. Дерекқор көшірмелері алға қарай қауіпсіз және иеленуші пулдағы кеңесші құлып (advisory lock) астында автоматты түрде қолданылады.

Аппараттық құрал

Бұл сандар — шлюз плюс PostgreSQL-дің жалғыз хосттағы орналастыруына арналған нұсқаулық. Sidecar-лар (STT/TTS, браузер, вектор қоймасы) өздерінің ізін қосады және әдетте тек шағын орналастырулар үшін ғана сол хостқа орналастырылады.

Профиль	CPU	RAM	Диск	Ескертпелер
Минимум (бағалау)	2 vCPU	2 GB	10 GB	Шлюз + Postgres, mock модель, sidecar-сыз
Ұсынылатын	4 vCPU	8 GB	40 GB SSD	Шлюз + Postgres + бірнеше sidecar
Дауыс / жергілікті модельдер	8+ vCPU (GPU қосымша)	16+ GB	80+ GB SSD	STT/TTS, embedder, жергілікті LLM соңғы нүктесі

Диск қолданысы әңгіме тарихымен, медиа blob каталогымен (AIHUMMER_BLOB_DIR), білім қабылдаумен және аудит сақтаумен өседі. PostgreSQL сақтық көшірмелерін (pg_dump + WAL/PITR) соған сай жоспарлаңыз.

Sidecar-лар (қосымша)

Sidecar-лар — бөлек HTTP қызметтер, әрқайсысы өзінің systemd бірлігі астында. Шлюз оларға 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-ларды нативті түрде дайындай алады немесе сіз бар sidecar-ды URL арқылы тіркей аласыз — Орнату бөлімін қараңыз.

LLM провайдерлер

AiHummer ешқашан ақылы модельді талап етпейді. Ол тегін/жергілікті модельдерде және Codex/ChatGPT-жазылым тасымалында бірден жұмыс істейді; әр жалгерге арналған BYOK кілттері қатаң түрде қосымша.

Қолдау көрсетілетін провайдерлер:

Anthropic.
OpenAI.
Кез келген OpenAI-API стандарты бар соңғы нүкте — жергілікті модель серверлері, OpenRouter немесе Gemini-дің OpenAI-үйлесімді соңғы нүктесі, мысалы.
Codex / ChatGPT-жазылым тасымалы — модельді есеп шотынан алынатын API кілтінің орнына ChatGPT жазылымы арқылы жүргізіңіз.

[!TIP] Егер шлюзді модель жалғанбай іске қоссаңыз (AIHUMMER_LLM_PROVIDER / AIHUMMER_LLM_MODEL / AIHUMMER_LLM_GATEWAY_URL), жауаптар детерминистік mock-тан келеді, осылайша нақты модельді жалғаудан бұрын арналар мен маршруттауды тексере аласыз.

[!NOTE] AiHummer тек OpenAI-үйлесімді POST /v1/chat/completions соңғы нүктесін ұсынады. /v1/models немесе /v1/embeddings HTTP соңғы нүктесі жоқ, және бақылау OTLP-push арқылы (Prometheus /metrics жоқ).

Әрі қарай қайда

Орналастыруға дайынсыз ба? Орнату бөліміне өтіңіз.
Алғашқы іске қосуды қадам-қадаммен жүргізгіңіз келе ме? Жылдам бастау бөлімін қараңыз.
Алдымен тұжырымдамалық модель керек пе? Кіріспе бөлімін оқыңыз.