Система талаптары — AiHummer Документация

AiHummer — бул хостту колдогон продукт: ал systemd астында чыгаруучу тарбол катары иштейт, ошондуктан талаптар атайын аз. Жалгыз оор көз карандылык — бул PostgreSQL менен Linux хост. Калгандары — сайдкарлар, чыныгы модель, вектор дүкөнү — ыргайлык жана кийинчерээк админ UI аркылуу кошсо болот.

[!NOTE] AiHummer болуп саналат хост-туурасынан, Docker эмес. Ал тарбол катары жана астында иштейт systemdдан ~/.aihummer (жүктөгөн колдонуучунун негизги каталогу орноткучу). Сизге контейнерди иштетүүчү, Kubernetes же башка эч нерсе керек эмес оркестрочу.

Иштөө тутуму

AiHummer иштейт Табият Linux гана. Windows же macOS сервер версиясы жок — шлюз жана анын кошумча компоненттери архитектура боюнча Linux продуктулары катары топтолуп, systemd менен орнотулат. (Кардар бөлүгү — бул өзүнчө мобилдик жана десктоп колдонмо; ал сервер эмес, канал.)

Заманбап 64-биттик Linux дистрибуциясы менен systemd.
x86_64 (amd64) же arm64 — орнотуучу ар архитектурага ылайыктуу пакетті тартып алат.
sudo/root кирүү катуу талап кылынбайт: кадимки орнотуу аркылуу жүргүзүлөт 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, браузер, вектордук сактагыч) өзүнүн аянтын кошот жана адатта алар чакан жайгаштыруулар үчүн гана ошол эле хостко коюлат.

Профиль	CPU	ОЗУ	Диск	Эскертмелер
Минимум (баалоо)	2 vCPU	2 ГБ	10 ГБ	Гейтвей + Постгрес, моделди макеттөө, кошумча контейнерлер жок
Сунуш кылынат	4 vCPU	8 ГБ	40 ГБ SSD	Шлюз + Postgres + бир нече сайдкарлар
Добуш / жергиликтүү моделдер	8+ vCPU (GPU ыктыярдуу)	16+ ГБ	80+ ГБ SSD	STT/TTS, эмбеддер, жергиликтүү LLM чекит

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

Жанкы балкалар (кызыкчылыктуу)

Сайдкарлар аралашпай HTTP кызматтары, ар бири өзүнүн systemd бирдигинин алдында. Шлюз аларга URL аркылуу жетет, андыктан сайдкар ошол эле хостто, башка хостто иштей алат же бар болгон экземплярга көрсөтө аласыз. Алардын баары акысыз/жергиликтүү жана негизги жайгаштыруу үчүн эч качан талап кылынбайт.

Сайдкар	Стандарттык порт	Иштетет
STT (жылдатылган сыдырма)	8001	Добушту текстке айландыруу
TTS (edge-tts)	8002	Сүйлөмдөрдү үн менен айтуу үчүн тексттен үн чыгаруучу
Видео (ffmpeg)	8005	Видеону түшүнүү
SearXNG	8888	Бул `web_search` асман
Chrome/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-и өтө эски дистрибутивдерде да кутудан чыга иштейт.

ЧОГ провайдерлери

AiHummer эч качан акы төлөнүүчү модельди талап кылбайт. Бул акысыз/жергиликтүү моделдерде жана Codex/ChatGPT жазылуу транспорту менен кутудан эле иштей берет; ар бир ижарачы үчүн BYOK ачкычтары толугу менен ыктыярдуу.

Колдоого алынган провайдерлер:

Антропикалык.
OpenAI.
Ар кандай OpenAI-API-стандартындагы анын аяк пункту — жергиликтүү модель серверлери, OpenRouter же Мисалы, Geminiнин OpenAI менен шайкеш аягына жетүү чекити.
Codex / 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).

Келерки кайда

Жандандыруга даярсызбы? Кетүү Орнотуу.
Биринчиден, кадам менен кадам баскычы менен жүргүңүз келееби? Караңыз Ыкчам баштоо.
Эң алды менен менталдык моделди каалайсыңбы? Окуңуз Киришүү.