AiHummer
Dansk▾
Log indKonto
v1.6.x▾
{ }Swagger

Konfiguration

v1.6.x · opdateret 2026-11-09

AiHummer konfigureres gennem en indstillingsoversigt, ikke en bunke miljøvariabler. gateway.env er kun bootstrap: databases DSN, lytteadresser/porte, hovednøglen og lignende. Hver anden nøgle findes i databasen og ændres fra webadministratorgrænsefladen under kørslen eller med aihummer settings CLI. Den vejledende regel er simpel: alt, der kan indstilles, kan konfigureres i Web UI — ikke kun env, og ikke hardkodet.

Løsningsrækkefølge

Hver katalogindstilling løses på samme måde, først match vinder:

  1. Database — en værdi indstillet via admin-brugergrænsefladen eller aihummer settings set.
  2. Standard — den indbyggede standard, der følger med udgivelsen.

Miljøet er med vilje ikke en del af denne kæde: for katalognøgler en AIHUMMER_* variabel i gateway.env er ignoreret, selvom det er indstillet. Det giver hver indstilling præcis én sandhedskilde — databasen — så en UI-værdi aldrig kan blive tyst overskygget af en glemt linje i en miljøfil.

[!NOTE] For at ændre adfærd i produktionen redigerer du ikke konfigurationsfiler — du ændrer indstilling i admin-UI’en (Administration → Indstillinger, en søgbar side) eller kør aihummer settings set <KEY> <VALUE> (get / list at læse), og det tager effekt for det pågældende arbejdsområde. Installatøren selv påfører de indledende katalogværdier ind i databasen via aihummer settings set.

Hot vs genstart-påkrævet

Hvordan en ændret indstilling træder i kraft afhænger af tasten:

Adfærd Eksempler Når det gælder
Hot værktøjsaktivering, underagent maks dybde Læses igen under kørsel, ingen genstart
Genstart kræves lytteadresse, kabling af visse tjenester Anvendt ved næste gateway-genstart

Genvejstaster læses live igen, så skift af et værktøj eller justering subagent-depth træder i kraft på næste tur. Nogle strukturelle nøgler træder kun i kraft efter en genstart; admin-brugergrænsefladen markerer, hvilke det er.

Bootstrap-variabler forbliver kun i miljøet

Nogle få variabler skal være til stede i miljøet, fordi de er nødvendige, før indstillingskataloget (og den database, det læser fra) eksisterer. Disse bootstrap variabler er kun til miljøet og vises ikke i administrations-brugerfladen:

Variabel Hvorfor det er bootstrap
AIHUMMER_DATABASE_URL Databasen skal eksistere, før nogen databaseunderstøttet indstilling kan læses.
AIHUMMER_DB_APP_URL Begrænset rolle DSN, der aktiverer RLS.
AIHUMMER_MASTER_KEY base64-32 byte; låser op for hemmeligheder-i-ro / hvelv / BYOK.
AIHUMMER_GATEWAY_ADDR Webpanelet, apps og kanaler bruger samme offentlige serveradresse. Åbn den offentlige adresse, installationsprogrammet viser; den lokale standardadresse er http://localhost:8780/. Porten valgt under installationen kan være en anden.
AIHUMMER_WEBUI_ADDR AIHUMMER_WEBUI_ADDR er en ekstra operatørlytter kun på loopback, som standard 127.0.0.1:8781, til kompatibilitet med første opsætning. Det er ikke en særskilt ekstern paneladresse; 0 er ugyldig. AIHUMMER_WEBUI_ENABLED=false deaktiverer panelet på begge lyttere.
AIHUMMER_BLOB_DIR Filsystemsti til blob/media-mappen — nødvendigt ved opstart.
AIHUMMER_OIDC_ISSUER Beskytter /v1/admin/* før UI’en er tillid til.

Ops wiring såsom telemetry OTLP-endpointet falder ind under samme bootstrap-kategori. Alt, der ikke er på denne korte liste, er en katalognøgle: det lever i databasen, og env ignoreres for det.

[!WARNING] Behold AIHUMMER_MASTER_KEY sikker og sikkerhedskopieret separat fra din database backup. Den dekrypterer legitimationslageret; mister du det, mister du de krypterede hemmeligheder kan ikke gendannes.

Konfigurationsfilen

For værts-native installationer befinder bootstrap-miljøet sig i en enkelt fil, som systemd-enheden indlæser:

~/.aihummer/etc/gateway.env

Rediger denne fil kun for bootstrap-værdier, genstart derefter gateway-tjenesten for at anvende ændringerne:

# ~/.aihummer/etc/gateway.env (excerpt)
AIHUMMER_DATABASE_URL=postgres://user:pass@localhost:5432/aihummer
AIHUMMER_MASTER_KEY=base64-32-bytes...
AIHUMMER_GATEWAY_ADDR=:8780
AIHUMMER_WEBUI_ADDR=127.0.0.1:8781
AIHUMMER_OIDC_ISSUER=https://idp.example/realms/main
systemctl restart aihummer-gateway

Alt ud over disse bootstrap-nøgler — agenter, værktøjer, hukommelsestilstand, ræsonnementsstrategier, budgetter, sikkerhedsforanstaltninger og resten — styres fra admin UI’s indstillinger (eller via aihummer settings), ikke fra denne fil: env ignoreres for disse nøgler.

Ledningsføring af valgfrie funktioner

Mange funktioner er slukket, indtil du peger dem på en backing-service. Alle disse nøgler er katalogindstillinger (de ligger i databasen): indstil dem i admin-UI’en (Administration → Indstillinger) eller med CLI; ved at sætte dem i gateway.env gør ingenting — env ignoreres for dem. For sidecars installeret fra bundtet (STT/TTS osv.) indsætter installatøren værdierne i databasen selv.

# Tilslut en rigtig modeludbyder for at få brugbare svar.
aihummer settings set AIHUMMER_LLM_PROVIDER openai
aihummer settings set AIHUMMER_LLM_MODEL gpt-4o-mini
aihummer settings set AIHUMMER_LLM_GATEWAY_URL https://api.openai.com/v1

# Enable tools by pointing at their backends

# Voice sidecars (STT/TTS auto-configured by the installer)
aihummer settings set AIHUMMER_STT_URL http://localhost:8001
aihummer settings set AIHUMMER_TTS_URL http://localhost:8002

# Real vector store + embedder (example URLs; the embedder is installed with
# --with-embedder, otherwise memory uses the lexical fallback)
aihummer settings set AIHUMMER_QDRANT_URL http://localhost:6333
aihummer settings set AIHUMMER_EMBEDDER_URL http://localhost:8080

[!TIP] Tilslut en rigtig modeludbyder for at få brugbare svar. En betalt API-nøgle er ikke nødvendig: brug en lokal OpenAI-kompatibel model, et understøttet abonnement eller din egen API-nøgle. Hvis ingen udbyder er konfigureret, vises fejlen: Ingen AI-modeludbyder er konfigureret endnu – tilføj en i afsnittet Modeller

Notifikationer

Administratorbrugergrænsefladerne Notifikationer siden (under “Kontrol”) er instansens indbakke for begivenheder (administrator login, opdatering tilgængelig/anvendt, sidecar går ned eller genopretter, og så videre) med filtre efter kategori, alvor og ulæste. Ved siden af den sidder en kategori × distributionskanal matrix: for hver begivenhedskategori du aktiverer webbrugergrænseflade, email, telegram og skub kanaler. Webbrugerfladenotifikationer leveres lokalt; Telegram er forbundet med knappen “Link Telegram” (dyb link), e-mail aktiveres, når supportadressen er bekræftet, og push-meddelelser kommer i mobilappen. Kritiske hændelser kan ikke dæmpes på webbrugerfladekanalen.

Hvor til næste