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

AiHummer — սա արտադրանք է, նախատեսված հոստի համար․ այն գործարկվում է որպես վերջնական tar-արխիվ systemd-ի տակ, դրա համար պահանջները դիտմամբ նվազագույն են։ Միակ խիստ կախյալությունը հոստն է՝ Linux-ով և PostgreSQL-ով։ Բոլորը մնացածը՝ sidecars, իրական մոդել, վեկտորյան պահոց — պարտադիր չէ և կարող է ավելացվել ավելի ուշ՝ վարչական ինտերֆեյսի միջոցով։

[!NOTE] AiHummer սա է հոսթում, ոչ թե Docker-ում. Այն տեղադրվում է որպես tarball՝ գործում է ներքո systemd-ից ~/.aihummer (Օգտագործողի տնային թղթապանակը, ով սկսեց տեղադրման ծրագիր). Ձեզ չի պետք runtime կոնտեյներ, Kubernetes կամ ինչ-որ բան օրքեստրատոր.

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

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

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

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

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

[!IMPORTANT] ԱԿտիվացնել pgcrypto նպատակային բազայում նախքան առաջին զանգվածային գործարկումը:
CREATE EXTENSION IF NOT EXISTS pgcrypto;

Դարպասը միանում է DSN-ի միջոցով AIHUMMER_DATABASE_URL. Բազմաբնակարան մեկուսացման համար դուք նաև կարող եք նշել AIHUMMER_DB_APP_URL սահմանափակ aihummer_app ռողի ակտիվացման համար Postgres Row-Level Security; տեղական կարգավորումները դա ավտոմատ կարգավորում են: Տվյալների բազայի միգրացիաները անվտանգ են թարմացման համար և կատարվում են ավտոմատ՝ սեփականատիրոջ պուլում խորհուրդացված կողպմամբ:

Պահանջվող սարքավորում

Այս թվերը ծառայում են որպես ուղեցույց դեպի գեյթվեյի և PostgreSQL-ի տեղադրում մեկ հոստի վրա: Սայդքարները (STT/TTS, բրաուզեր, վեկտորային պահոց) ավելացնում են իրենց սեփական հետքը և սովորաբար տեղադրվում են նույն հոստում միայն փոքր չափերով հիմնադրում

Պրոֆիլ	ԱԿՊ	ԱԿՊ	Թ_disc_	Նշումներ
Ազդարար (գնահատական)	2 վիրտուալ պրոցեսոր (vCPU)	2 ԳԲ	10 ԳԲ	Գեյթըվեյ + Postgres, մոդելի նմուշ, առանց սայդքարների
Խորհուրդ է տրվում	4 վիրտուալ պրոցեսոր (vCPU)	8 ԳԲ	40 ԳԲ SSD	Գեյթվեյ + Postgres + մի քանի սայլդքեր
Ձայնային / տեղակալի մոդելներ	8+ vCPU (GPU ըստ ցանկության)	16+ ԳԲ	SSD 80+ ԳԲ	STT/TTS, էմբեդերներ, տեղական վերջնական կետ LLM

Դիսկի օգտագործումը աճում է զրույցների պատմության հետ, մուլտիմեդիա ֆայլերի կատալոգը (AIHUMMER_BLOB_DIR), գիտելիքների յուրացում և աուդիտի պահպանություն: Պլանավորեք PostgreSQL-ի պահուստավորում (pg_dump + WAL/PITR) համապատասխանաբար:

Սայդկարային (համապատասխանության դեպքում)

Ապահովագուրեր պայմանի HTTP-ծառայություններ, յուրաքանչյուրը իր սեփական unit 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, կամ Օրինակ՝ OpenAI-ով համատեղելի Gemini վերջնակետը:
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-push է (առանց Prometheus) /metrics).

Որտեղից հետո

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