Configuration

~/.aihummer/etc/gateway.env

# ~/.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=:8781
AIHUMMER_OIDC_ISSUER=https://idp.example/realms/main

systemctl restart aihummer-gateway

# Wire a real model (unset → deterministic mock)
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

AiHummer est configuré via un **catalogue des paramètres**, pas un tas de variables d'environnement. `gateway.env` est **bootstrap seulement**: le DSN de la base de données, les adresses/ports d'écoute, la clé principale et ainsi de suite. Chaque autre clé se trouve dans la base de données et est modifiée depuis l'interface d'administration web à l'exécution ou avec le `aihummer settings` CLI. La règle directrice est simple : **tout ce qui est réglable est configurable dans l'interface Web** — pas uniquement pour l'environnement, et pas codé en dur. ## L'ordre de résolution Chaque paramètre de catalogue est résolu de la même manière, le premier résultat l'emporte : 1. **Base de données** — une valeur définie via l'interface d'administration ou `aihummer settings set`. 2. **Par défaut** — le paramètre par défaut intégré livré avec la version. L'environnement est **délibérément pas partie de cette chaîne**: pour les clés de catalogue `AIHUMMER_*` variable dans `gateway.env` est **ignoré**, même si défini. Cela donne à chaque paramètre exactement une source de vérité — la base de données — de sorte qu’une valeur de l’interface utilisateur ne puisse jamais être silencieusement éclipsée par une ligne oubliée dans un fichier env. > [!NOTE] > Pour changer le comportement en production, vous n'éditez pas les fichiers de configuration — vous changez le > paramètre dans l’interface d’administration (**Gestion → Paramètres**, une page consultable) ou exécuter > `aihummer settings set <KEY> <VALUE>` (`get` / `list` à lire), et cela prend > effet pour cet espace de travail. L'installateur lui-même initialise les valeurs du catalogue > dans la base de données via `aihummer settings set`. ## Chaud vs redémarrage requis La manière dont un paramètre modifié prend effet dépend de la clé : | Comportement | Exemples | Lorsqu'il s'applique | |---|---|---| | **Chaud** | activation de l'outil, profondeur maximale du sous-agent | Relire à l'exécution, pas de redémarrage | | **Redémarrage requis** | écouter l'adresse, câblage de certains services | Appliqué au prochain redémarrage de la passerelle | Les touches de raccourci sont relues en temps réel, donc basculer un outil ou ajuster `subagent-depth` prend effet au prochain tour. Certaines clés structurelles ne prennent effet qu'après un redémarrage ; l'interface admin indique lesquelles sont lesquelles. ## Les variables Bootstrap restent uniquement dans l'environnement Quelques variables doivent être présentes dans l'environnement car elles sont nécessaires avant que le catalogue de paramètres (et la base de données dont il se lit) n'existe. Celles-ci **bootstrap** les variables sont uniquement pour l'environnement et ne sont pas visibles dans l'interface d'administration : | Variable | Pourquoi c'est bootstrap | |---|---| | `AIHUMMER_DATABASE_URL` | La base de données doit exister avant que tout paramètre reposant sur une base de données puisse être lu. | | `AIHUMMER_DB_APP_URL` | Rôle DSN restreint qui active le RLS. | | `AIHUMMER_MASTER_KEY` | base64-32 octets ; déverrouille les secrets au repos / coffre-fort / BYOK. | | `AIHUMMER_GATEWAY_ADDR` | Adresse d'écoute publique (par défaut `:8780`) — API, jumelage, WS/SSE, entrant et le proxy de l'application/poche. | | `AIHUMMER_WEBUI_ADDR` | Adresse d'écoute de l'interface Web d'administration privée (par défaut `:8781`), servi à la racine `/`; réglé sur `0` désactiver. | | `AIHUMMER_BLOB_DIR` | Chemin du système de fichiers du répertoire blob/media — nécessaire au démarrage. | | `AIHUMMER_OIDC_ISSUER` | Protège `/v1/admin/*` avant que l'interface utilisateur ne soit approuvée. | Le câblage Ops tel que le point de terminaison OTLP de télémétrie relève de la même catégorie de démarrage. Tout ce qui n'est pas sur cette courte liste est une clé du catalogue : il vit dans la base de données, et env est ignoré pour celui-ci. > [!WARNING] > Garder `AIHUMMER_MASTER_KEY` sûr et sauvegardé **séparément** depuis votre base de données > sauvegarde. Il déchiffre le coffre des identifiants ; le perdre signifie perdre les secrets chiffrés > ne peut pas être récupéré. ## Le fichier de configuration Pour les installations natives sur l'hôte, l'environnement de bootstrap se trouve dans un seul fichier que l'unité systemd charge : ```text ~/.aihummer/etc/gateway.env ``` Modifier ce fichier **pour les valeurs de bootstrap uniquement**, puis redémarrez le service de passerelle pour appliquer les modifications : ```ini # ~/.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=:8781 AIHUMMER_OIDC_ISSUER=https://idp.example/realms/main ``` ```bash systemctl restart aihummer-gateway ``` Tout ce qui va au-delà de ces clés de démarrage — agents, outils, mode mémoire, stratégies de raisonnement, budgets, garde-fous et le reste — est géré depuis les paramètres de l'interface administrateur (ou via `aihummer settings`), pas à partir de ce fichier : env est ignoré pour ces clés. ## Câblage des fonctionnalités optionnelles De nombreuses fonctionnalités sont désactivées jusqu'à ce que vous les dirigiez vers un service de support. Toutes ces clés sont des paramètres de catalogue (elles se trouvent dans la base de données) : définissez-les dans l'interface d'administration (**Gestion → Paramètres**) ou avec l'interface en ligne de commande ; en les mettant dans `gateway.env` ne fait rien — env est ignoré pour eux. Pour les sidecars installés à partir du bundle (STT/TTS, etc.), l'installateur insère les valeurs dans la base de données elle-même. ```bash # Wire a real model (unset → deterministic mock) 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] > Un vrai modèle n'est jamais nécessaire. Sans `AIHUMMER_LLM_*` connecté, les réponses arrivent > à partir d'une simulation déterministe ; AiHummer fonctionne également sur OpenAI compatible gratuit/local > points de terminaison et un transport par abonnement Codex/ChatGPT, avec BYOK en option. ## Notifications L'interface d'administration **Notifications** la page (sous « Contrôle ») est la boîte de réception des événements de l'instance (connexion de l'administrateur, mise à jour disponible/appliquée, arrêt ou récupération du sidecar, et ainsi de suite) avec des filtres par catégorie, gravité et non lus. À côté se trouve un **matrice catégorie × canal de livraison**: pour chaque catégorie d'événement que vous activez **interface web**, **e-mail**, **télégramme** et **pousser** canaux. Les notifications de l'interface Web sont livrées localement ; Telegram est lié avec le bouton "Lier Telegram" (lien profond), l'email s'active une fois que l'adresse de support est vérifiée, et les notifications push arrivent dans l'application mobile. Les événements critiques ne peuvent pas être mis en sourdine sur le canal webui. ## Où aller ensuite - Verrouillez la connexion administrateur : [Première connexion](/fr/v1.0/getting-started/first-login). - Voir où se trouvent les fichiers : [Installation](/fr/v1.0/getting-started/installation). - Vérifiez les prérequis : [Exigences](/fr/v1.0/getting-started/requirements).