Համակարգային պահանջներ — AiHummer Փաստաթղթեր

AiHummer-ը host-native արտադրանք է. այն աշխատում է որպես systemd-ի տակ թողարկման tarball, ուստի պահանջները միտումնավոր փոքր են։ Միակ կոշտ կախվածությունը Linux հոսթն է PostgreSQL-ով։ Մնացած ամեն ինչ — sidecar-ներ, իրական մոդել, vector store — ընտրովի է և կարող է ավելացվել ավելի ուշ ադմին UI-ից։

[!NOTE] AiHummer-ը host-native է, ոչ Docker։ Այն տեղակայվում է որպես systemd-ի տակ /home/.aihummer-ից աշխատող tarball։ Ձեզ պետք չէ կոնտեյների runtime, Kubernetes կամ որևէ orchestrator։

Օպերացիոն համակարգ

AiHummer-ն աշխատում է միայն Linux-ի վրա։ Windows կամ macOS սերվեր build չկա — gateway-ը և իր sidecar-ները փաթեթավորված են որպես ըստ-ճարտարապետության Linux artifact-ներ և տեղակայվում են systemd-ով։ (Հաճախորդը առանձին բջջային ու դեսքթոփ հավելված է. դա ալիք է, ոչ սերվեր։)

Ժամանակակից 64-բիթ Linux դիստրիբուտիվ systemd-ով։
x86_64 (amd64) կամ arm64 — տեղադրիչը ներքաշում է համապատասխան ըստ-ճարտ. փաթեթը։
sudo/root մուտք՝ տեղադրման արմատը գրելու և systemd unit-ները գրանցելու համար։

Տվյալների բազա

PostgreSQL-ն է միակ կոշտ կախվածությունը և բոլոր վիճակի ճշմարտության միակ աղբյուրը։ pgcrypto ընդլայնումը պարտադիր է — այն ապահովում է գաղտնագրված հավատարմագրերի vault-ը։ Առանց տվյալների բազայի՝ gateway-ը գործարկվում է կրճատված health-only ռեժիմում և ոչ մի օգտակար բան չի սպասարկում։

[!IMPORTANT] Միացրեք pgcrypto-ն թիրախ տվյալների բազայում առաջին գործարկումից առաջ.
CREATE EXTENSION IF NOT EXISTS pgcrypto;

Gateway-ը միանում է AIHUMMER_DATABASE_URL-ում DSN-ի միջոցով։ Բազմավարձակալ մեկուսացման համար դուք կարող եք լրացուցիչ ուղղել AIHUMMER_DB_APP_URL-ը սահմանափակ aihummer_app դերին՝ Postgres Row-Level Security-ն ակտիվացնելու համար. լոկալ տեղադրումները սա կարգավորում են ավտոմատ կերպով։ Տվյալների բազայի migration-ները առաջ-անվտանգ են և կիրառվում են ավտոմատ կերպով owner pool-ի վրա advisory lock-ի տակ։

Սարքավորում

Այս թվերը ուղեցույց են 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 unit-ի տակ։ Gateway-ը դրանց հասնում է URL-ով, ուստի sidecar-ը կարող է աշխատել նույն հոսթի վրա, մեկ այլ հոսթի վրա, կամ դուք կարող եք ուղղել գոյություն ունեցող օրինակի։ Դրանք բոլորն անվճար/լոկալ են և երբեք պարտադիր չեն բազային տեղակայման համար։

Sidecar	Լռելյայն պորտ	Միացնում է
STT (faster-whisper)	8001	Speech-to-text ձայնային ընթացքների համար
TTS (edge-tts)	8002	Text-to-speech ձայնային ընթացքների համար
Diarize (pyannote)	8003	Խոսողի դիարիզացիա
Voiceclone (OpenVoice V2)	8004	Ձայնի կլոնավորում
Video (ffmpeg)	8005	Տեսանյութի ընկալում
SearXNG	8888	`web_search` գործիքը
Chrome/CDP	9222	`browser` / `computer` գործիքները

Տեղադրիչը կարող է sidecar-ները ապահովել native-ով, կամ դուք կարող եք կցել գոյություն ունեցողը URL-ով — տես Տեղադրում։

LLM մատակարարներ

AiHummer-ը երբեք չի պահանջում վճարովի մոդել։ Այն աշխատում է անմիջապես տուփից դուրս անվճար/լոկալ մոդելների և Codex/ChatGPT-բաժանորդագրության փոխադրման վրա. ըստ-վարձակալի BYOK բանալիները խստորեն ընտրովի են։

Աջակցվող մատակարարներ.

Anthropic։
OpenAI։
Ցանկացած OpenAI-API-ստանդարտ վերջնակետ — լոկալ մոդելի սերվերներ, OpenRouter կամ Gemini-ի OpenAI-համատեղելի վերջնակետ, օրինակ։
Codex / ChatGPT-բաժանորդագրության փոխադրում — կառավարեք մոդելը ChatGPT բաժանորդագրության միջոցով, այլ ոչ թե վճարվող API բանալիով։

[!TIP] Եթե դուք gateway-ը գործարկեք առանց մոդելի միացման (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)։

Ուր հետո

Պատրա՞ստ եք տեղակայման։ Անցեք Տեղադրում։
Ուզու՞մ եք անցնել առաջին գործարկման միջով քայլ առ քայլ։ Տես Արագ մեկնարկ։
Ուզու՞մ եք նախ մտավոր մոդելը։ Կարդացեք Ներածություն։