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

AiHummer жергілікті хостқа арналған өнім: ол systemd астында релиздік tarball ретінде жұмыс істейді, сондықтан талаптар әдейі аз. Жалғыз негізгі тәуелділік — 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 қатары деңгейіндегі қауіпсіздікті іске қосу үшін рөл; жергілікті орнатулар оны автоматты түрде орнатады. Дерекқор миграциялары алға қауіпсіз болып табылады және меншік иесінің пулындағы кеңесші құлып астында автоматты түрде қолданылады.

Аппараттық қамтамасыз ету

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

Профиль	Орталық процессор бірлігі	RAM	Диск	Ескертпелер
Минимум (бағалау)	2 vCPU	2 ГБ	10 ГБ	Шақыру + Postgres, үлгі моделін көрсету, ешқандай қосымша контейнерлер жоқ
Ұсынылады	4 vCPU	8 ГБ	40 ГБ SSD	Gateway + Postgres + бірнеше сайдкарлар
Дауыс / жергілікті модельдер	8+ виртуалды процессор (GPU таңдаулы)	16+ ГБ	80+ ГБ SSD	STT/TTS, енгізуші, жергілікті LLM соңғы нүктесі

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

Бүйірлік қондырғылар (міндетті емес)

Сайдкарлар дара HTTP қызметтері, олардың әрқайсысы өз systemd бірлігіне тәуелді. Шлюз оларды URL арқылы табады, сондықтан sidecar бірдей хостта, басқа хостта жұмыс істей алады немесе бар экземплярға бағыттай аласыз. Барлығы тегін/жергілікті және негізгі орналастыру үшін ешқашан міндетті емес.

Сайдкар	Әдепкі порт	Қосу
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-і тым ескі дистрибутивтерде де қораптан шыға жұмыс істейді.

LLM жеткізушілері

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

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

Антроптық
OpenAI.
Кез келген OpenAI-API-стандартты тіркелу нүктесі — жергілікті модель серверлері, OpenRouter немесе Мысалы, Gemini-дің OpenAI-мен үйлесетін соңғы нүктесі.
Кодекс / 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).

Келесі қайда

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