Талаботҳои система
AiHummer маҳсулоти маҳаллӣ барои сервер мебошад: он ҳамчун releasing tarball дар зери systemd кор мекунад, бинобар ин талаботҳо сохторӣ ва хурд мебошанд. Танҳо вобастагӣ сахт як сервери Linux бо PostgreSQL аст. Ҳама чизҳои дигар — sidecars, модели воқеӣ, мағозаи векторӣ — ихтиёрӣ мебошанд ва метавонанд баъдтар аз интерфейси идоракунӣ илова шаванд.
[!NOTE] AiHummer ин аст меҳмон-меҳмонхона, на Докер. Ин ҳамчун як файли тарболл таҳти идора фаъол мешавад systemd аз
~/.aihummer(қатораи хонагӣ барои корбарие, ки идора кард насбкунандаи). Шумо ба муҳити иҷрои контейнер, Kubernetes ё чизе дигар ниёз надоред оркестратор
Системаи амалиётӣ
AiHummer кор мекунад Танҳо LinuxҲеҷ гуна насбкунандаи Windows ё macOS server вуҷуд надорад — дарвоза ва барномаҳои канории он ҳамчун ашёи Linux мутобиқ ба меъморӣ бастабанди мешаванд ва бо systemd насб карда мешаванд. (Муштарӣ як барномаи мобилӣ ва мизи кории ҷудо аст; он канале мебошад, на сервер.)
- Тақсимоти нави Linux-и 64-битаи муосир бо
systemd. x86_64(amd64) ёarm64— насбкунанда бастаи мувофиқ барои ҳар як аркаро мекашад.sudo/дострасӣ ба реша аст муҳим нест: насбкунӣ оддӣ тавассутиsudo, аммо иҷро кардани насбкунанда бидуни ҳуқуқи root AiHummer-ро бе root насб мекунад режими зерsystemd --user— бинед Насб.
Пойгоҳи додаҳо
PostgreSQL аст танҳо вобастагии сахт ва манбаи ягонаи ҳақиқат барои тамоми давлат. pgcrypto тамдид аст лазарем — он поддержкаи анбори шифршудаи шаҳодатномаҳоро таъмин мекунад. Бидуни базаи дода, раъноиш дар режими камшиддат танҳо барои саломатӣ оғоз мешавад ва чизе муфид хизмат намекунад.
[!IMPORTANT] Фаъол кардан
pgcryptoдар пойгоҳи додаҳои мақсад қабл аз иҷрои аввал:CREATE EXTENSION IF NOT EXISTS pgcrypto;
Дарвозаро тавассути DSN пайваст мекунад AIHUMMER_DATABASE_URLБарои изолятсияи бисёрмуҳассилӣ шумо метавонед иловатан нишон диҳед AIHUMMER_DB_APP_URL дар маҳдудшуда aihummer_app нақшаро барои фаъол кардани Амният дар сатҳи сатрҳои Postgres; насби маҳаллӣ инро ба таври худкор танзим мекунад. Муҳоҷирати маълумотномаҳо бехатар мебошанд ва таҳти бастаи машваратӣ дар ҳавзии соҳиби маълумот ба таври худкор татбиқ мешаванд.
Таҷҳизот
Ин рақамҳо роҳнамо барои насби яккабонаи дарвозаи плюс PostgreSQL мебошанд. Sidecarҳо (STT/TTS, браузер, анбори вектор) таъсири худро мегузоранд ва одатан танҳо барои насби хурд дар ҳамон сервер ҷой мегиранд.
| Профил | Пешрафтаи марказии коркард | RAM | Диск | Ёддоштҳо |
|---|---|---|---|---|
| Ҳадди ақали (баҳо) | 2 CPU-и виртуалӣ | 2 ГБ | 10 ГБ | Gateway + Postgres, модели сохта, бе sidecar |
| Тавсияшаванда | 4 CPU-и виртуалӣ | 8 ГБ | 40 ГБ SSD | Шояд + Postgres + якчанд паҳлӯӣ |
| Овоз / моделҳои маҳаллӣ | 8+ vCPU (GPU ихтиёрӣ) | 16+ ГБ | 80+ ГБ SSD | STT/TTS, вурудгар, нуқтаи маҳаллии LLM |
Истифодаи диски компютер бо таърихи гуфтугӯ ва директорияи медиа-блоб зиёд мешавад (AIHUMMER_BLOB_DIR), фаҳмиши дониш ва нигоҳдории назоратӣ. Нусхабардорӣҳои PostgreSQL-ро (pg_dump + WAL/PITR) мувофиқи раёсат нақш кунед.
Сайдкарҳо (ихтиёрӣ)
Сайдкарҳо инанд хизматрасониҳои ҷудогонаи HTTPҳар кадоме таҳти воҳиди системди худ. Дарвоза тавассути URL ба онҳо мерасад, бинобар ин як саидкар метавонад дар ҳамон хост, дар хости дигар сохта шавад, ё шумо метавонед ба нусхаи мавҷуда ишора кунед. Ҳамаи онҳо ройгон/махалӣ мебошанд ва ҳеҷ гоҳ барои ҷорӣ кардани асосӣ талаб карда намешаванд.
| Сайдкар | Порти пешфарзӣ | Имкон медиҳад |
|---|---|---|
| STT (шепидан зудтар) | 8001 | Сухан ба матн барои гардиши овоз |
| TTS (edge-tts) | 8002 | Матн ба овоз барои гардиши овоз |
| Видео (ffmpeg) | 8005 | Фаҳмиши видео |
| SearXNG | 8888 | Он web_search асбоб |
| Хром/CDP | 9222 | Он browser / computer асбобҳо |
STT, TTS, видео, ҷустуҷӯи веб (SearXNG) ва браузер (CloakBrowser) ҳама тавассути насбкунанда аз қуттӣ насб мешаванд. Бастаҳои ҷустуҷӯ ва браузер дар маҷмӯаи насбкунандаи имзошуда ҷойгиранд ва ба таври офлайн насб мешаванд: онҳоро бо флагҳои --no-search / --no-browser хомӯш кунед, ё ба ҷои насби маҳаллӣ нусхаи аллакай коркунандаи худро бо --external-search=URL / --external-browser=URL пайваст кунед. Сайдкарҳои овозиро бо тағйирёбандаҳои AIHUMMER_SKIP_* гузаронед. Эмбедери семантикӣ ихтиёрӣ фаъол мешавад (--with-embedder): он PyTorch-ро (садҳо МБ) мекашад, ва бе он хотира ба ҷустуҷӯи луғавӣ бармегардад. Нигаред Насб.
[!NOTE] Node.js (версияи 20 ва навтар) низ дар маҷмӯаи насбкунанда ҷойгир аст ва ба таври офлайн насб мешавад, бинобар ин плагинҳои Node.js — барномаи AiHummer, pocket-agent ва коннекторҳои каналӣ — ҳатто дар дистрибутивҳое, ки Node.js-и худашон кӯҳна аст, аз қуттӣ кор мекунанд.
Таъминкунандагони LLM
AiHummer ҳеҷ гоҳ ба модели пулакӣ ниёз надорад. Он бо моделҳои ройгон/махалӣ ва нақлиёти обунаи Codex/ChatGPT фавран кор мекунад; калидҳои BYOK барои ҳар як иҷоранишин комилан ихтиёрӣ мебошанд.
Провайдерҳои дастгиришаванда:
- Антропик
- ОпенАИ
- Ҳар як нуқтаи охирини стандартии OpenAI-API — серверҳои маҳалли модел, OpenRouter, ё Ҳадди охири мувофиқи OpenAI-и Gemini, масалан.
- Кодекс / нақлиёти обунаи ChatGPT — моделро тавассути ChatGPT идора кунед обуна ба ҷои калиди API пардохтшуда.
[!TIP] Агар шумо дарвозаро бидуни модел пайвастшуда оғоз кунед (
AIHUMMER_LLM_PROVIDER/AIHUMMER_LLM_MODEL/AIHUMMER_LLM_GATEWAY_URL), ҷавобҳо аз як системаи муайянкунанда меоянд меҳрӯбиқарор кардан то шумо метавонед каналҳоро тасдиқ кунед ва суръатдиҳӣ пеш аз пайваст кардани модели воқеӣ
[!NOTE] AiHummer танҳо он чизеро ошкор мекунад, ки бо OpenAI мувофиқ аст
POST /v1/chat/completionsтаппонча. Он ҷо аст не/v1/modelsё/v1/embeddingsНуқтаи охири HTTP, ва нурдиҳӣ OTLP-пуш аст (Prometheus нест)/metrics).