Талаботи система
AiHummer маҳсулоти host-native аст: он ҳамчун tarball-и релиз дар зери systemd кор мекунад, бинобар ин талабот қасдан хурд мебошанд. Ягона вобастагии сахт хости Linux бо PostgreSQL аст. Ҳама чизи дигар — sidecar-ҳо, модели воқеӣ, vector store — ихтиёрӣ аст ва баъдтар аз интерфейси маъмурӣ илова карда мешавад.
[!NOTE] AiHummer host-native аст, на Docker. Он ҳамчун tarball, ки дар зери systemd аз
/home/.aihummerкор мекунад, ҷойгир мешавад. Шумо ба runtime-и контейнер, Kubernetes ё ягон orchestrator ниёз надоред.
Системаи оператсионӣ
AiHummer танҳо дар Linux кор мекунад. Build-и сервери Windows ё macOS нест — gateway ва sidecar-ҳои он ҳамчун артефактҳои Linux-и ба ҳар меъморӣ баставсба мешаванд ва бо systemd ҷойгир карда мешаванд. (Client як аппликейшни алоҳидаи мобилӣ ва десктоп аст; ин канал аст, на сервер.)
- Дистрибутиви муосири 64-бита Linux бо
systemd. x86_64(amd64) ёarm64— насбкунанда бастаи ба ҳар меъморӣ мувофиқро мекашад.- Дастрасии
sudo/root барои навиштани решаи насб ва сабти воҳидҳои systemd.
Пойгоҳи додаҳо
PostgreSQL ягона вобастагии сахт ва манбаи ягонаи ҳақиқат барои тамоми ҳолат
аст. Васеъшавии pgcrypto талаб карда мешавад — он vault-и рамзшудаи
эътимономаро дастгирӣ мекунад. Бе пойгоҳи додаҳо, gateway дар ҳолати камшудаи
танҳо-саломатӣ оғоз меёбад ва чизи муфиде хизмат намерасонад.
[!IMPORTANT]
pgcrypto-ро дар пойгоҳи додаҳои ҳадаф пеш аз иҷрои аввал фаъол кунед:CREATE EXTENSION IF NOT EXISTS pgcrypto;
Gateway тавассути DSN дар AIHUMMER_DATABASE_URL пайваст мешавад. Барои
ҷудосозии multitenant шумо метавонед ба таври иловагӣ AIHUMMER_DB_APP_URL-ро ба
як нақши маҳдудшудаи aihummer_app равона кунед, то Postgres Row-Level Security-ро
фаъол кунед; насбҳои маҳаллӣ инро ба таври худкор танзим мекунанд. Migration-ҳои
пойгоҳи додаҳо forward-safe мебошанд ва ба таври худкор дар зери advisory lock дар
owner pool татбиқ карда мешаванд.
Сахтафзор
Ин рақамҳо роҳнамоӣ барои ҷойгиркунии як хости gateway плюс PostgreSQL мебошанд. Sidecar-ҳо (STT/TTS, браузер, vector store) изи худро илова мекунанд ва одатан танҳо барои ҷойгиркуниҳои хурд дар ҳамон хост ҷойгир карда мешаванд.
| Профил | 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-и маҳаллӣ |
Истифодаи диск бо таърихи сӯҳбат, директорияи blob-и медиа
(AIHUMMER_BLOB_DIR), ворид кардани дониш ва нигоҳдории аудит меафзояд. Нусхаҳои
захиравии PostgreSQL-ро (pg_dump + WAL/PITR) мутобиқан банақша гиред.
Sidecar-ҳо (ихтиёрӣ)
Sidecar-ҳо хидматҳои алоҳидаи HTTP мебошанд, ҳар яке дар зери воҳиди systemd-и худ. Gateway ба онҳо бо URL мерасад, бинобар ин як sidecar метавонад дар ҳамон хост, дар хости дигар кор кунад, ё шумо метавонед ба як нусхаи мавҷуда равона кунед. Ҳамаи онҳо ройгон/маҳаллӣ мебошанд ва ҳеҷ гоҳ барои ҷойгиркунии асосӣ талаб карда намешаванд.
| Sidecar | Порти пешфарз | Фаъол мекунад |
|---|---|---|
| STT (faster-whisper) | 8001 | Speech-to-text барои навбатҳои овозӣ |
| TTS (edge-tts) | 8002 | Text-to-speech барои навбатҳои овозӣ |
| Diarize (pyannote) | 8003 | Diarization-и сухангӯ |
| Voiceclone (OpenVoice V2) | 8004 | Клонкунии овоз |
| Video (ffmpeg) | 8005 | Фаҳмиши видео |
| SearXNG | 8888 | Абзори web_search |
| Chrome/CDP | 9222 | Абзорҳои browser / computer |
Насбкунанда метавонад sidecar-ҳоро ба таври маҳаллӣ таъмин кунад ё шумо метавонед як нусхаи мавҷударо бо URL пайваст кунед — ба Насб нигаред.
Провайдерҳои LLM
AiHummer ҳеҷ гоҳ модели пулакиро талаб намекунад. Он берун аз қуттӣ дар моделҳои ройгон/маҳаллӣ ва интиқоли обунаи Codex/ChatGPT кор мекунад; калидҳои BYOK-и ҳар як tenant қатъиян ихтиёрӣ мебошанд.
Провайдерҳои дастгиришаванда:
- Anthropic.
- OpenAI.
- Ҳар нуқтаи интиҳоии стандарти OpenAI-API — серверҳои модели маҳаллӣ, OpenRouter, ё нуқтаи интиҳоии бо OpenAI мутобиқи Gemini, масалан.
- Интиқоли обунаи Codex / ChatGPT — моделро тавассути обунаи ChatGPT идора кунед, на калиди API-и ҳисобшаванда.
[!TIP] Агар шумо gateway-ро бе васлкунии модел (
AIHUMMER_LLM_PROVIDER/AIHUMMER_LLM_MODEL/AIHUMMER_LLM_GATEWAY_URL) оғоз кунед, ҷавобҳо аз mock-и детерминистӣ меоянд, бинобар ин шумо метавонед каналҳо ва routing-ро пеш аз пайваст кардани модели воқеӣ тасдиқ кунед.
[!NOTE] AiHummer танҳо нуқтаи интиҳоии бо OpenAI мутобиқи
POST /v1/chat/completions-ро дар ихтиёр мегузорад. Нуқтаи интиҳоии HTTP-и/v1/modelsё/v1/embeddingsнест, ва мушоҳидапазирӣ OTLP-push аст (бе Prometheus-и/metrics).