AiHummer
Norsk▾
Logg påKonto
v1.6.x▾
{ }Swagger

Konfigurasjon

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

AiHummer er konfigurert gjennom en innstillingskatalog, ikke en haug med miljøvariabler. gateway.env er bare bootstrap: databases DSN, lytteadresser/porter, hovednøkkelen og lignende. Alle andre nøkler ligger i databasen og endres fra webadministrasjonsgrensesnittet under kjøring eller med aihummer settings CLI. Den ledende regelen er enkel: alt som kan justeres er konfigurerbart i nettgrensesnittet — ikke kun for miljøvariabler, og ikke hardkodet.

Løsningsrekkefølge

Hver kataloginnstilling løses på samme måte, først til mølla vinner:

  1. Database — en verdi satt gjennom admin-UI eller aihummer settings set.
  2. Standard — den innebygde standarden som følger med utgivelsen.

Miljøet er med vilje ikke en del av denne kjeden: for katalognøkler en AIHUMMER_* variabel i gateway.env er ignorert, selv om det er satt. Det gir hver innstilling nøyaktig én sannhetskilde — databasen — slik at en UI-verdi aldri kan bli tyst overskygget av en glemt linje i en miljøfil.

[!NOTE] For å endre atferd i produksjon redigerer du ikke konfigurasjonsfiler — du endrer innstilling i administrasjonsgrensesnittet (Administrasjon → Innstillinger, en søkbar side) eller kjør aihummer settings set <KEY> <VALUE> (get / list å lese), og det tar effekt for det arbeidsområdet. Selve installasjonsprogrammet legger inn de første katalogverdiene inn i databasen via aihummer settings set.

Varme vs omstart nødvendig

Hvordan en endret innstilling trer i kraft, avhenger av tasten:

Atferd Eksempler Når det gjelder
Varm verktøyaktivering, maksimal dybde for underagent Leses på nytt under kjøring, ingen omstart
Omstart kreves lytteadresse, kabling av enkelte tjenester Gjelder ved neste omstart av gateway

Hurtigtaster leses på nytt live, så bytte av et verktøy eller justering subagent-depth trer i kraft på neste runde. Noen strukturelle nøkler trer kun i kraft etter en omstart; administrasjonsgrensesnittet markerer hvilken som er hvilken.

Bootstrap-variabler forblir kun i miljøet

Noen få variabler må være til stede i miljøet fordi de trengs før innstillingskatalogen (og databasen den leser fra) eksisterer. Disse bootstrap variabler er kun for miljøet og vises ikke i administrasjonsgrensesnittet:

Variabel Hvorfor det er bootstrap
AIHUMMER_DATABASE_URL Databasen må eksistere før noen databasebaserte innstillinger kan leses.
AIHUMMER_DB_APP_URL Begrenset rolle-DSN som aktiverer RLS.
AIHUMMER_MASTER_KEY base64-32 byte; låser opp hemmeligheter-i-ro / hvelv / BYOK.
AIHUMMER_GATEWAY_ADDR Nettpanelet, apper og kanaler bruker samme offentlige serveradresse. Åpne den offentlige adressen som installasjonsprogrammet viser; lokal standardadresse er http://localhost:8780/. Porten som ble valgt under installasjonen kan være en annen.
AIHUMMER_WEBUI_ADDR AIHUMMER_WEBUI_ADDR er en ekstra operatørlytter kun på loopback, som standard 127.0.0.1:8781, for kompatibilitet ved førstegangsoppsett. Dette er ikke en egen ekstern paneladresse; 0 er ugyldig. AIHUMMER_WEBUI_ENABLED=false deaktiverer panelet på begge lytterne.
AIHUMMER_BLOB_DIR Filsystembane til blob/media-katalogen — nødvendig ved oppstart.
AIHUMMER_OIDC_ISSUER Beskytter /v1/admin/* før brukergrensesnittet er pålitelig.

Ops-kabling som for eksempel telemetri-OTLP-endepunktet faller inn under samme bootstrap-kategori. Alt som ikke er på denne korte listen er en katalognøkkel: det lever i databasen, og env blir ignorert for det.

[!WARNING] Beholde AIHUMMER_MASTER_KEY trygg og sikkerhetskopiert separat fra databasen din backup. Den dekrypterer legitimasjonslageret; mister du det, går de krypterte hemmelighetene tapt kan ikke gjenopprettes.

Konfigurasjonsfilen

For verts-native installasjoner, befinner bootstrap-miljøet seg i en enkelt fil som systemd-enheten laster:

~/.aihummer/etc/gateway.env

Rediger denne filen kun for bootstrap-verdier, og start deretter gateway-tjenesten på nytt for å bruke endringene:

# ~/.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 utover disse bootstrap-nøklene — agenter, verktøy, minnemodus, resonnementstrategier, budsjetter, sikkerhetsmekanismer og resten — administreres fra administrasjonsgrensesnittets innstillinger (eller via aihummer settings), ikke fra denne filen: env blir ignorert for de nøklene.

Kabling av valgfrie funksjoner

Mange funksjoner er slått av til du peker dem mot en støttetjeneste. Alle disse nøklene er kataloginnstillinger (de ligger i databasen): sett dem i administrasjonsgrensesnittet (Administrasjon → Innstillinger) eller med CLI; legger dem i gateway.env gjør ingenting — env blir ignorert for dem. For sidecars installert fra pakken (STT/TTS osv.) fyller installasjonsprogrammet verdiene inn i databasen selv.

# Koble til en ekte modellleverandør for å få nyttige 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] Koble til en ekte modellleverandør for å få nyttige svar. En betalt API-nøkkel er ikke påkrevd: bruk en lokal OpenAI-kompatibel modell, et støttet abonnement eller din egen API-nøkkel. Hvis ingen leverandør er konfigurert, vises feilen: Ingen AI-modellleverandør er konfigurert ennå – legg til en i Modeller-delen

Varsler

Administratorgrensesnittet Varsler side (under “Control”) er instansens innboks for hendelser (admin-innlogging, oppdatering tilgjengelig/anvendt, sidecar som går ned eller kommer tilbake, og så videre) med filtre etter kategori, alvorlighetsgrad og uleste. Ved siden av den sitter en kategori × leveringskanal-matrise: for hver hendelseskategori du aktiverer nettgrensesnitt, e-post, telegram og dytte kanaler. Web UI-varsler leveres lokalt; Telegram er koblet til med “Link Telegram”-knappen (dyplenke), e-post aktiveres når støtteadressen er bekreftet, og push-varsler mottas i mobilappen. Kritiske hendelser kan ikke dempes på webui-kanalen.

Hvor til neste