AiHummer
Dansk▾
Log indKonto
v1.1.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Kom godt i gang/Systemkrav

Systemkrav

v1.1.x · opdateret 2026-07-05

AiHummer er et host-native produkt: det kører som en udgivelses-tarball under systemd, så kravene er bevidst små. Den eneste hårde afhængighed er en Linux-host med PostgreSQL. Alt andet — sidecars, en rigtig model, en vektorlager — er valgfrit og kan tilføjes senere fra administrations-UI’en.

[!NOTE] AiHummer er vært-native, ikke Docker. Det implementeres som en tarball, der kører under systemd fra ~/.aihummer (hjemmemappen for den bruger, der kørte installer). Du behøver ikke en container runtime, Kubernetes eller nogen dirigent.

Operativsystem

AiHummer kører på Kun Linux. Der findes ingen Windows- eller macOS server-version — gatewayen og dens sidecars er pakket som Linux-artifakter for hver arkitektur og deployeres med systemd. (Klienten er en separat mobil- og desktop-app; det er en kanal, ikke serveren.)

  • En moderne 64-bit Linux-distribution med systemd.
  • x86_64 (amd64) eller arm64 — installationsprogrammet henter den matchende per-arkitekturpakke.
  • sudo/root-adgang er ikke strengt nødvendigt: en normal installation kører via sudo, men at køre installationsprogrammet uden root installerer AiHummer uden root tilstand under systemd --user — se Installation.

Database

PostgreSQL er kun hård afhængighed og den eneste kilde til sandhed for al tilstand. pgcrypto udvidelse er påkrævet — det understøtter det krypterede legitimationsdepot. Uden en database starter gatewayen i en reduceret kun-sundhed tilstand og leverer intet nyttigt.

[!IMPORTANT] Aktivér pgcrypto i mål-databasen før første kørsel:

CREATE EXTENSION IF NOT EXISTS pgcrypto;

Gatewayen forbinder via en DSN i AIHUMMER_DATABASE_URL. For multitenant isolation kan du desuden pege AIHUMMER_DB_APP_URL på en begrænset aihummer_app rolle til at aktivere Postgres Row-Level Security; lokale installationer opsætter dette automatisk. Databasemigrationer er fremad-sikre og anvendes automatisk under en rådgivende lås på ejerpoolen.

Hardware

Disse tal er vejledende for en enkelt-host-implementering af gatewayen plus PostgreSQL. Sidecars (STT/TTS, browser, vektor-lager) tilføjer deres eget fodaftryk og placeres normalt kun på samme host for små implementeringer.

Profil CPU RAM Disk Noter
Minimum (eval) 2 vCPU 2 GB 10 GB Gateway + Postgres, mockmodel, ingen sidecars
Anbefalet 4 vCPU 8 GB 40 GB SSD Gateway + Postgres + et par sidecars
Stemme / lokale modeller 8+ vCPU (GPU valgfrit) 16+ GB 80+ GB SSD STT/TTS, embedder, lokal LLM-endpoint

Diskforbrug vokser med samtalehistorik, medieblob-mappen (AIHUMMER_BLOB_DIR), videnindtagelse og revisionens opbevaring. Planlæg PostgreSQL-sikkerhedskopier (pg_dump + WAL/PITR) i overensstemmelse hermed.

Sidevogne (valgfrit)

Sidevogne er separate HTTP-tjenester, hver under sin egen systemd-enhed. Gatewayen tilgår dem via URL, så en sidecar kan køre på samme vært, på en anden vært, eller du kan pege på en eksisterende instans. De er alle gratis/lokale og aldrig nødvendige for en grundlæggende implementering.

Sidevogn Standardport Muliggør
STT (faster-whisper) 8001 Tale-til-tekst for stemmeskift
TTS (edge-tts) 8002 Tekst-til-tale for stemmeskift
Video (ffmpeg) 8005 Videoforståelse
SearXNG 8888 Den web_search værktøj
Chrome/CDP 9222 Den browser / computer værktøjer

STT, TTS, video, websøgning (SearXNG) og browseren (CloakBrowser) installeres alle direkte af installationsprogrammet. Søge- og browserpakkerne leveres inde i det signerede installationsbundle og installeres offline: slå dem fra med --no-search / --no-browser, eller tilslut en instans, du allerede kører, med --external-search=URL / --external-browser=URL i stedet for en lokal installation. Spring stemmesidecars over med AIHUMMER_SKIP_* variablerne. Den semantiske indlejrer er tilvalg (--with-embedder): den henter PyTorch (hundreder af MB), og uden den falder hukommelsen tilbage til leksikalsk søgning. Se Installation.

[!NOTE] Node.js (version 20 eller nyere) leveres også inde i installationsbundlet og installeres offline, så Node.js-plugins — AiHummer-appen, pocket-agent og kanalforbindelserne — virker med det samme, selv på distributioner hvis egen Node.js er for gammel.

LLM-udbydere

AiHummer kræver aldrig en betalt model. Den fungerer direkte med gratis/lokale modeller og en Codex/ChatGPT-abonnementsforbindelse; per-lejer BYOK-nøgler er helt valgfri.

Understøttede udbydere:

  • Antropisk.
  • OpenAI.
  • Enhver OpenAI-API-standardendpoint — lokale modelservere, OpenRouter, eller Geminis OpenAI-kompatible endpoint, for eksempel.
  • Codex / ChatGPT-abonnements transport — køre en model gennem en ChatGPT abonnement snarere end en faktureret API-nøgle.

[!TIP] Hvis du starter gatewayen uden en tilsluttet model (AIHUMMER_LLM_PROVIDER / AIHUMMER_LLM_MODEL / AIHUMMER_LLM_GATEWAY_URL), svar kommer fra en deterministisk gøre nar af så du kan validere kanaler og routing før tilslutning af en rigtig model.

[!NOTE] AiHummer udsætter kun OpenAI-kompatible POST /v1/chat/completions endepunkt. Der er nej /v1/models eller /v1/embeddings HTTP-endpoint, og observabilitet er OTLP-push (ingen Prometheus /metrics).

Hvor til næste