Sistemos reikalavimai — AiHummer Dokumentai

AiHummer yra natyvus pagrindiniam kompiuteriui produktas: jis veikia kaip išleistas tarbolas po systemd, todėl reikalavimai sąmoningai maži. Vienintelė griežta priklausomybė yra Linux pagrindinis kompiuteris su PostgreSQL. Viskas kita — šalutinės paslaugos, tikras modelis, vektorinė saugykla — yra neprivalomi ir gali būti pridėti vėliau iš administratoriaus sąsajos.

[!NOTE] AiHummer yra vietinis šeimininkas, ne Docker. Jis diegiamas kaip tarball ir veikia po systemd iš ~/.aihummer (naudotojo, kuris paleido, pagrindinis katalogas) diegtuvas). Jums nereikia konteinerio vykdymo aplinkos, Kubernetes ar bet ko kito organizatorius.

Operacinė sistema

AiHummer veikia su Tik Linux. Nėra „Windows“ ar „macOS“ serverio versijos — vartai ir jų šalutiniai moduliai yra supakuoti kaip Linux artefaktai pagal architektūrą ir diegiami naudojant systemd. (Klientas yra atskira mobilioji ir darbalaukio programėlė; tai kanalas, o ne serveris.)

Šiuolaikinė 64 bitų Linux platinimo versija su systemd.
x86_64 (amd64) arba arm64 — diegimo programa traukia atitinkamą pagal architektūrą paketą.
sudo/root prieiga yra nėra griežtai privaloma: normalus diegimas vyksta per sudo, bet paleidus diegimo programą be administratoriaus teisių, AiHummer įdiegiama be administratoriaus teisių režimas žemiau systemd --user — žiūrėti Įdiegimas.

Duomenų bazė

PostgreSQL yra tik griežta priklausomybė ir vienintelis tiesos šaltinis visai būsenai. Tas pgcrypto plėtinys yra reikalingas — jis palaiko užšifruotą kredencialų saugyklą. Be duomenų bazės, vartai paleidžiami sumažinto tik sveikatos režimu ir nieko naudingo nepateikia.

[!IMPORTANT] Įjungti pgcrypto tikslinei duomenų bazei prieš pirmąjį paleidimą:
CREATE EXTENSION IF NOT EXISTS pgcrypto;

Ši vartai prisijungia per DSN į AIHUMMER_DATABASE_URL. Daugiau nuomotojų atskyrimui galite papildomai nukreipti AIHUMMER_DB_APP_URL ribotoje aihummer_app role, kad suaktyvintų „Postgres“ eilutės lygmens saugą; vietinės diegimo versijos tai nustato automatiškai. Duomenų bazės migracijos yra saugios į priekį ir taikomos automatiškai pagal patarimų užraktą savininkų baseine.

Aparatūra

Šios skaičiai yra rekomendacijos vieno serverio diegimui su gateway ir PostgreSQL. Šoninės paslaugos (STT/TTS, naršyklė, vektorinė saugykla) turi savo resursų poreikį ir paprastai dedamos ant to paties serverio tik mažiems diegimams.

Profilis	CPU	RAM	Diskas	Pastabos
Minimum (vertinimas)	2 vCPU	2 GB	10 GB	Tarpinė stotis + Postgres, imituotas modelis, be papildomų konteinerių
Rekomenduojama	4 vCPU	8 GB	40 GB SSD	Vartai + Postgres + keli šalutiniai konteineriai
Balso / vietiniai modeliai	8+ vCPU (GPU neprivaloma)	16+ GB	80+ GB SSD	STT/TTS, įterpėjas, vietinis LLM galinis taškas

Disko naudojimas didėja su pokalbių istorija, medijos blob katalogas (AIHUMMER_BLOB_DIR), žinių įsisavinimas ir audito saugojimas. Atsargines PostgreSQL kopijas planuokite atitinkamai (pg_dump + WAL/PITR).

Šoninės karietos (pasirenkama)

Šoninės transporto priemonės yra atskirtos HTTP paslaugos, kiekvienas savo systemd vienete. Vartai juos pasiekia per URL, todėl sidecar gali veikti tame pačiame serveryje, kitame serveryje, arba galite nurodyti esamą instanciją. Visi jie yra nemokami / vietiniai ir niekada nėra būtini pagrindiniam diegimui.

Šoninė priekaba	Numatytasis prievadas	Įjungia
STT (greitesnis šnabždesys)	8001	Kalbos į tekstą balsams
TTS (edge-tts)	8002	Teksto pavertimas kalba balso perėjimams
Vaizdo įrašas (ffmpeg)	8005	Vaizdo įrašų supratimas
SearXNG	8888	Tas `web_search` įrankis
Chrome/CDP	9222	Tas `browser` / `computer` įrankiai

STT, TTS, vaizdo įrašas, interneto paieška (SearXNG) ir naršyklė (CloakBrowser) — visi įdiegiami iš karto diegimo metu. Paieškos ir naršyklės paketai keliauja pasirašytame diegiklio rinkinyje ir įdiegiami neprisijungus prie tinklo: išjunkite juos su --no-search / --no-browser arba vietoj vietinio diegimo prijunkite jau veikiančią instanciją su --external-search=URL / --external-browser=URL. Balso šonines programas praleiskite su AIHUMMER_SKIP_* kintamaisiais. Semantinis įterpėjas yra prisijungti (--with-embedder): jis traukia PyTorch (šimtai MB), o be jo atmintis grįžta prie leksinės paieškos. Žr. Įdiegimas.

[!NOTE] Node.js (20 versija ar naujesnė) taip pat keliauja diegiklio rinkinyje ir įdiegiamas neprisijungus prie tinklo, todėl Node.js papildiniai — AiHummer programėlė, pocket-agent ir kanalų jungtys — veikia iš karto net tose distribucijose, kurių savas Node.js per senas.

LLM teikėjai

AiHummer niekada nereikalauja mokamo modelio. Jis veikia tiesiog iš karto su nemokamais/vietiniais modeliais ir Codex/ChatGPT prenumeratos transportu; kiekvieno nuomininko BYOK raktai yra visiškai neprivalomi.

Palaikomi teikėjai:

Antropinis.
OpenAI.
Bet kuris OpenAI API standartinis galinis taškas — vietiniai modelių serveriai, OpenRouter arba Pavyzdžiui, Gemini OpenAI suderinamas galinis taškas.
Kodeksas / ChatGPT prenumeratos transportas — vairuoti modelį per ChatGPT prenumerata, o ne apmokestinamas API raktas.

[!TIP] Jei paleisite vartus be prijungto modelio (AIHUMMER_LLM_PROVIDER / AIHUMMER_LLM_MODEL / AIHUMMER_LLM_GATEWAY_URL), atsakymai ateina iš deterministinio pašiepti taip galite patvirtinti kanalus ir maršrutizavimas prieš prisijungiant prie tikro modelio.

[!NOTE] AiHummer atskleidžia tik OpenAI suderinamus POST /v1/chat/completions galinis taškas. Yra ne /v1/models arba /v1/embeddings HTTP galinis taškas, ir stebimumas yra OTLP-push (ne Prometheus) /metrics).

Kur toliau

Pasiruošę diegti? Eikite į Įdiegimas.
Norite žingsnis po žingsnio pereiti pirmąjį veiksmą? Peržiūrėkite Greitas pradžia.
Norite pirmiausia psichinės modelio? Perskaitykite Įvadas.