Systemkrav — AiHummer Dokument

AiHummer är en host-native produkt: den körs som ett release-tarball under systemd, så kraven är medvetet små. Det enda hårda beroendet är en Linux-värd med PostgreSQL. Allt annat — sidokomponenter, en riktig modell, en vektorlager — är valfritt och kan läggas till senare från administrationsgränssnittet.

[!NOTE] AiHummer är värd-native, inte Docker. Det distribueras som en tarball som körs under systemd från ~/.aihummer (hemanvändarkatalogen för användaren som körde installatör). Du behöver ingen container-runtime, Kubernetes eller något dirigent.

Operativsystem

AiHummer körs på Endast Linux. Det finns ingen Windows- eller macOS-server-version — gatewayen och dess sidecars är paketerade som Linux-artifakter per arkitektur och distribueras med systemd. (Klienten är en separat mobil- och skrivbordsapp; det är en kanal, inte servern.)

En modern 64-bitars Linux-distribution med systemd.
x86_64 (amd64) eller arm64 — installationsprogrammet hämtar den matchande per-arkitekturpaketet.
sudo/rootåtkomst är inte strikt nödvändigt: en normal installation körs via sudo, men att köra installatören utan root installerar AiHummer utan root läge under systemd --user — se Installation.

Databas

PostgreSQL är endast hårt beroende och den enda sanningskällan för all status. Den pgcrypto förlängning är krävs — det stöder det krypterade autentiseringsvalvet. Utan en databas startar gatewayen i ett reducerat endast hälsa-läge och levererar ingenting användbart.

[!IMPORTANT] Aktivera pgcrypto i mål-databasen innan första körningen:
CREATE EXTENSION IF NOT EXISTS pgcrypto;

Gatewayen ansluter via en DSN i AIHUMMER_DATABASE_URL. För isolering av flera hyresgäster kan du dessutom peka AIHUMMER_DB_APP_URL på en begränsad aihummer_app roll för att aktivera Postgres radnivåsäkerhet; lokala installationer ställer in detta automatiskt. Databas-migreringar är framåtsäkra och tillämpas automatiskt under ett rådgivande lås på ägarpoolen.

Hårdvara

Dessa siffror är riktlinjer för en enskild värdinstallation av gatewayen plus PostgreSQL. Sidecars (STT/TTS, webbläsare, vektorlagring) tillför sitt eget fotavtryck och placeras vanligtvis på samma värd endast för små installationer.

Profil	CPU	RAM	Disk	Anteckningar
Minimum (utvärdering)	2 vCPU	2 GB	10 GB	Gateway + Postgres, mockmodell, inga sidovagnar
Rekommenderad	4 vCPU	8 GB	40 GB SSD	Gateway + Postgres + ett par sidovagnar
Röst / lokala modeller	8+ vCPU (GPU valfritt)	16+ GB	80+ GB SSD	STT/TTS, inbäddare, lokal LLM-endpunkt

Diskanvändning ökar med konversationshistorik, mediemappens blob-directory (AIHUMMER_BLOB_DIR), kunskapsinhämtning och revisionsbeständighet. Planera PostgreSQL-säkerhetskopior (pg_dump + WAL/PITR) därefter.

Sidovagnar (valfritt)

Sidvagnar är separata HTTP-tjänster, var och en under sin egen systemd-enhet. Gatewayen når dem via URL, så en sidecar kan köras på samma värd, på en annan värd, eller så kan du peka på en befintlig instans. De är alla gratis/lokala och aldrig nödvändiga för en grundläggande installation.

Sidvagn	Standardport	Aktiverar
STT (faster-whisper)	8001	Tal-till-text för röstvändningar
TTS (edge-tts)	8002	Text-till-tal för röstvändningar
Video (ffmpeg)	8005	Videoförståelse
SearXNG	8888	Den `web_search` verktyg
Chrome/CDP	9222	Den `browser` / `computer` verktyg

STT, TTS, video, webbsökning (SearXNG) och webbläsaren (CloakBrowser) installeras alla direkt ur lådan av installationsprogrammet. Sök- och webbläsarnyttolasterna levereras inuti det signerade installationspaketet och installeras offline: stäng av dem med --no-search / --no-browser, eller anslut en instans du redan kör med --external-search=URL / --external-browser=URL i stället för en lokal installation. Hoppa över röstsidovagnarna med AIHUMMER_SKIP_*-variablerna. Den semantiska inbäddaren är opt-in (--with-embedder): den laddar PyTorch (hundratals MB), och utan den återgår minnet till lexikalisk sökning. Se Installation.

[!NOTE] Node.js (version 20 eller nyare) levereras också inuti installationspaketet och installeras offline, så Node.js-tillägg — AiHummer-appen, pocket-agent och kanalkopplingarna — fungerar direkt ur lådan även på distributioner vars egen Node.js är för gammal.

LLM-leverantörer

AiHummer kräver aldrig en betalmodell. Det fungerar direkt med gratis/lokala modeller och en Codex/ChatGPT-prenumeration; BYOK-nycklar per hyresgäst är strikt valfria.

Stödda leverantörer:

Antropisk.
OpenAI.
Vilken som helst OpenAI-API-standardendpoint — lokala modellservrar, OpenRouter, eller Geminis OpenAI-kompatibla slutpunkt, till exempel.
Codex / ChatGPT-prenumeration transport — köra en modell genom en ChatGPT prenumeration snarare än en fakturerad API-nyckel.

[!TIP] Om du startar gatewayen utan en ansluten modell (AIHUMMER_LLM_PROVIDER / AIHUMMER_LLM_MODEL / AIHUMMER_LLM_GATEWAY_URL), svar kommer från en deterministisk håna så att du kan validera kanaler och rutter innan du ansluter en riktig modell.

[!NOTE] AiHummer visar endast de som är kompatibla med OpenAI POST /v1/chat/completions ändpunkt. Det finns nej /v1/models eller /v1/embeddings HTTP-slutpunkt, och observabilitet är OTLP-push (ingen Prometheus /metrics).

Vart härnäst

Redo att distribuera? Gå till Installation.
Vill du gå igenom det första loppet steg för steg? Se Snabbstart.
Vill du ha den mentala modellen först? Läs Introduktion.