Systemkrav — AiHummer Dokumenter

AiHummer er et vertsnativt produkt: det kjører som en utgivelsestarball under systemd, så kravene er bevisst små. Den eneste harde avhengigheten er en Linux-vert med PostgreSQL. Alt annet — sidecars, en ekte modell, en vektorlagring — er valgfritt og kan legges til senere fra administrasjonsgrensesnittet.

[!NOTE] AiHummer er vert-nativ, ikke Docker. Den distribueres som en tarball som kjører under systemd fra ~/.aihummer (hjemmekatalogen til brukeren som kjørte installer). Du trenger ikke en container-runtime, Kubernetes eller noe som helst dirigent.

Operativsystem

AiHummer kjører på Kun Linux. Det finnes ingen Windows- eller macOS-server-versjon — gatewayen og dens sidecarer pakkes som Linux-artifakter per arkitektur og distribueres med systemd. (Klienten er en separat mobil- og skrivebordsapp; det er en kanal, ikke serveren.)

En moderne 64-biters Linux-distribusjon med systemd.
x86_64 (amd64) eller arm64 — installatøren henter den matchende per-arkitektur-pakken.
sudo/root-tilgang er ikke strengt nødvendig: en normal installasjon kjører via sudo, men å kjøre installasjonsprogrammet uten root installerer AiHummer i rootless modus under systemd --user — se Installasjon.

Database

PostgreSQL er kun hard avhengighet og den eneste sannhetskilden for all tilstand. Den pgcrypto utvidelse er påkrevd — det støtter den krypterte legitimasjonsbeholderen. Uten en database starter gatewayen i en redusert bare-helse-modus og fungerer ikke med noe nyttig.

[!IMPORTANT] Aktiver pgcrypto i mål-databasen før første kjøring:
CREATE EXTENSION IF NOT EXISTS pgcrypto;

Gatewayen kobler til via en DSN i AIHUMMER_DATABASE_URL. For flerbrukerisolasjon kan du i tillegg peke AIHUMMER_DB_APP_URL på en begrenset aihummer_app rolle for å aktivere Postgres radnivåsikkerhet; lokale installasjoner setter dette opp automatisk. Databasemigrasjoner er fremoversikre og brukes automatisk under en rådgivende lås på eierpoolen.

Maskinvare

Disse tallene er veiledning for en enkelt-verts implementering av gatewayen pluss PostgreSQL. Sidecars (STT/TTS, nettleser, vektorlagring) legger til sitt eget fotavtrykk og plasseres vanligvis på samme vert kun for små implementeringer.

Profil	CPU	RAM	Disk	Notater
Minimum (eval)	2 vCPU	2 GB	10 GB	Gateway + Postgres, mockmodell, ingen sidecars
Anbefalt	4 vCPU	8 GB	40 GB SSD	Gateway + Postgres + et par sidecars
Stemme / lokale modeller	8+ vCPU (GPU valgfritt)	16+ GB	80+ GB SSD	STT/TTS, embedder, lokal LLM-endepunkt

Diskbruk øker med samtalehistorikk, mediemappe-direktoriet (AIHUMMER_BLOB_DIR), kunnskapsinnhenting og revisjonsoppbevaring. Planlegg PostgreSQL-sikkerhetskopier (pg_dump + WAL/PITR) deretter.

Sidevogner (valgfritt)

Sidevogner er separate HTTP-tjenester, hver under sin egen systemd-enhet. Gatewayen når dem via URL, så en sidecar kan kjøre på samme vert, på en annen vert, eller du kan peke på en eksisterende instans. De er alle gratis/lokale og aldri nødvendige for en grunnleggende distribusjon.

Sidevogn	Standardport	Muliggjør
STT (raskere-hviske)	8001	Tale-til-tekst for talebruk
TTS (edge-tts)	8002	Tekst-til-tale for stemmeskift
Video (ffmpeg)	8005	Videoforståelse
SearXNG	8888	Den `web_search` verktøy
Chrome/CDP	9222	Den `browser` / `computer` verktøy

STT, TTS, video, nettsøk (SearXNG) og nettleseren (CloakBrowser) installeres alle rett ut av boksen av installasjonsprogrammet. Nyttelasten for søk og nettleser leveres inne i den signerte installasjonspakken og installeres frakoblet: slå dem av med --no-search / --no-browser, eller koble til en instans du allerede kjører med --external-search=URL / --external-browser=URL i stedet for en lokal installasjon. Hopp over stemme-sidevognene med AIHUMMER_SKIP_* variabler. Den semantiske innebyggeren er meld deg på (--with-embedder): det henter PyTorch (hundrevis av MB), og uten det faller minnet tilbake til leksikalsk søk. Se Installasjon.

[!NOTE] Node.js (versjon 20 eller nyere) leveres også inne i installasjonspakken og installeres frakoblet, så Node.js-plugins — AiHummer-appen, pocket-agent og kanaltilkoblingene — fungerer rett ut av boksen selv på distribusjoner der systemets egen Node.js er for gammel.

LLM-leverandører

AiHummer krever aldri en betalt modell. Den fungerer rett ut av boksen på gratis/lokale modeller og en Codex/ChatGPT-abonnementstransport; BYOK-nøkler per leietaker er helt valgfrie.

Støttede leverandører:

Antropisk.
OpenAI.
Enhver OpenAI-API-standardendepunkt — lokale modellservere, OpenRouter, eller Geminis OpenAI-kompatible endepunkt, for eksempel.
Codex / ChatGPT-abonnements transport — kjøre en modell gjennom en ChatGPT abonnement i stedet for en fakturert API-nøkkel.

[!TIP] Hvis du starter gatewayen uten en koblet modell (AIHUMMER_LLM_PROVIDER / AIHUMMER_LLM_MODEL / AIHUMMER_LLM_GATEWAY_URL), svar kommer fra en deterministisk hån så du kan validere kanaler og ruting før tilkobling av en ekte modell.

[!NOTE] AiHummer eksponerer bare OpenAI-kompatible POST /v1/chat/completions endepunkt. Det er nei /v1/models eller /v1/embeddings HTTP-endepunkt, og observability er OTLP-push (ikke Prometheus /metrics).

Hvor til neste

Klar til å distribuere? Gå til Installasjon.
Vil du gå gjennom den første løypen steg for steg? Se Rask start.
Vil du ha den mentale modellen først? Les Introduksjon.