AiHummer
Français▾
ConnexionCompte
v1.6.x▾
{ }Swagger

Variables d'environnement

v1.6.x · mis à jour 2026-11-15

AIHUMMER_PUBLIC_TLS_CERT_FILE + AIHUMMER_PUBLIC_TLS_KEY_FILE: HTTPS peut être servi par la passerelle avec une paire certificat/clé privée ou par votre proxy inverse. Une paire configurée invalide ne provoque jamais de repli vers HTTP en clair. Avant d’approuver un certificat privé dans l’application, comparez son empreinte SHA-256 au terminal d’installation de confiance.

La configuration AiHummer se divise en deux groupes strictement différents:

  1. Bootstrap (gateway.env) — ce que la passerelle doit savoir avant il peut lire la base de données : le DSN de la base de données, les adresses d’écoute, les répertoires statiques, la clé principale. Seules ces clés sont lues depuis l’environnement.
  2. Catalogue des paramètres (base de données) — tous les autres boutons. Ceux-ci sont rangés dans le base de données et définie dans l’interface d’administration web (Gestion → Paramètres) ou avec aihummer settings set <KEY> <VALUE>. Pour ces clés a gateway.env valeur est délibérément ignoré — même si défini, il a aucun effet.

Modèle de configuration

gateway.env est bootstrap seulement. Ordre de résolution :

  • Clé du catalogue des paramètres: database value → built-in default (l’environnement est ignoré);
  • clé de démarrage: environment variable only.

Ainsi, la source unique de vérité pour les réglages réglables est la base de données (interface d’administration Web / aihummer settings); l’environnement ne contient que ce dont le processus a besoin pour démarrer.

Le fichier de configuration pour une installation native sur l’hôte se trouve à :

# /home/.aihummer/etc/gateway.env
AIHUMMER_DATABASE_URL=postgres://...
AIHUMMER_MASTER_KEY=base64-32-bytes

[!TIP] Ne mettez pas les boutons du catalogue des paramètres gateway.env — cela n’a aucun effet. Changer eux dans l’interface d’administration web (Gestion → Paramètres, elle a une recherche) ou via aihummer settings set. Certains changements (comme les basculements d’outils et les sous-agents profondeur) appliquer chaud ; d’autres nécessitent un redémarrage du service.

Bootstrap (gateway.env)

Les seules clés que la passerelle lit réellement à partir de l’environnement.

Noyau et base de données

Variable But
AIHUMMER_DATABASE_URL Requis. DSN Postgres. Sans lui, la passerelle fonctionne en mode santé seulement.
AIHUMMER_DB_APP_URL DSN à rôle restreint qui active la sécurité au niveau des lignes (défini automatiquement pour les installations locales).
AIHUMMER_GATEWAY_ADDR Le panneau web, les applications et les canaux partagent une seule adresse publique du serveur. Ouvrez l’adresse publique indiquée par l’installateur ; l’adresse locale par défaut est http://localhost:8780/. Le port choisi pendant l’installation peut différer.
AIHUMMER_WEBUI_ADDR AIHUMMER_WEBUI_ADDR est un écouteur auxiliaire d’exploitation sur loopback uniquement, par défaut 127.0.0.1:8781, pour la compatibilité de l’initialisation. Ce n’est pas une autre adresse externe du panneau ; 0 est invalide. AIHUMMER_WEBUI_ENABLED=false désactive le panneau sur les deux écouteurs.
AIHUMMER_DEFAULT_WORKSPACE_ID Sélectionne l’espace de travail par défaut pour les intégrations entrantes configurées.
AIHUMMER_HOME_ROOT Installe la racine (normalement dérivée du chemin binaire) ; ancre les répertoires admin-ui/blob/installer et les fichiers clés.
AIHUMMER_BLOB_DIR Active le service média/fichier (répertoire de stockage de blobs). Il stocke également artefacts de plugin privés (chargés latéralement) sous blob: références que le déployeur résout.
AIHUMMER_ADMIN_UI_DIR Le panneau web, les applications et les canaux partagent une seule adresse publique du serveur. /

Secrets et infrastructure

Variable But
AIHUMMER_MASTER_KEY 32 octets encodés en base64 ; active les secrets au repos, le coffre-fort et BYOK.
AIHUMMER_MEDIA_TOKEN_SECRET Maintient les URL de téléchargement signées valides après les redémarrages.
AIHUMMER_OTEL_ENDPOINT Point de terminaison OTLP pour la transmission de traces/métriques.
AIHUMMER_DOWNLOAD_BASE_URL URL de base pour les artefacts de version (source de mise à jour automatique).

[!WARNING] L’observabilité est OTLP push uniquement. AiHummer fait pas exposer un Prométhée /metrics point de terminaison ou /debug/pprof. Point AIHUMMER_OTEL_ENDPOINT à votre collectionneur à la place.

Catalogue des paramètres (base de données — interface web d’administration ou aihummer settings)

Chaque clé ci-dessous se trouve dans la base de données. Configurez-la dans l’interface d’administration Web (Gestion → Paramètres) ou comme ceci :

aihummer settings set AIHUMMER_LLM_PROVIDER openai

A gateway.env la valeur pour une telle clé est ignoré.

Sécurité

Clé But
AIHUMMER_APPROVAL_TOOLS Outils qui nécessitent l’approbation humaine avant de s’exécuter.
AIHUMMER_AIRGAPPED 1 bloque la sortie publique contrôlée par le modèle (mode isolé).
AIHUMMER_AUDIT_RETENTION_DAYS Fenêtre de rétention pour le journal d’audit administrateur.
AIHUMMER_INBOUND_SECRET Secret partagé HMAC pour connecteur → passerelle /v1/inbound/* appels.

Authentification et SSO

Clé But
AIHUMMER_OIDC_ISSUER Protège /v1/admin/*. Sans cela (et sans LDAP/SAML), l’administrateur fait confiance aux en-têtes de développement — ne jamais exposer une telle instance.

LDAP/AD et SAML sont configurés aux côtés de OIDC pour la connexion d’entreprise ; SCIM fournit l’approvisionnement automatique des utilisateurs. Voir Webhooks, SCIM et jumelage.

LLM et modèles

Clé But
AIHUMMER_LLM_PROVIDER Fournisseur de modèle à utiliser.
AIHUMMER_LLM_MODEL Nom du modèle.
AIHUMMER_LLM_GATEWAY_URL URL de base d’une passerelle/point de terminaison LLM compatible OpenAI (le AIHUMMER_LLM_* chemin ; distinct de l’origine AIHUMMER_OPENAI_BASE_URL). Voir BYOK et fournisseurs.
AIHUMMER_OPENAI_API_KEY Clé API pour un fournisseur compatible OpenAI.
AIHUMMER_SUBAGENT_MAX_DEPTH Profondeur maximale des sous-agents générés.

[!NOTE] Connectez un véritable fournisseur de modèles pour obtenir des réponses utiles. Une clé API payante n’est pas obligatoire : utilisez un modèle local compatible OpenAI, un abonnement pris en charge ou votre propre clé API. Si aucun fournisseur n’est configuré, l’erreur suivante apparaît : Aucun fournisseur de modèle d'IA n'est encore configuré : ajoutez-en un dans la section Modèles

Outils

Clé But
AIHUMMER_FS_ROOT Restreint davantage la racine de fichiers autorisée ; une valeur vide ne donne pas accès à l’hôte.
AIHUMMER_DB_QUERY_DSN Permet db_query (lecture seule) contre ce DSN.
AIHUMMER_CODE_EXEC code_exec est désactivé par défaut
AIHUMMER_BROWSER_PROFILE_SOCKET Chemin vers le socket privé managed-profiles.sock du service de navigateur ; vide — les profils persistants de computer sont désactivés.
AIHUMMER_BROWSER_PROFILE_BINDINGS Tableau JSON de liaisons explicites de profils de navigateur persistants (profile_id, tenant_id, user_id, agent_ids, conversation_ids).

La recherche web et le navigateur sont gérés par l’installateur : ils sont installés d’origine, se désactivent avec --no-search / --no-browser et se pointent vers une instance existante avec --external-search=URL / --external-browser=URL — il n’existe aucun réglage opérateur pour eux.

Voir le plein Catalogue d’outils pour ce que fait chaque outil.

Voix et side-cars

Clé But
AIHUMMER_STT_URL URL de l’interface audio-texte (initialisée par l’installateur).
AIHUMMER_TTS_URL URL du module complémentaire de synthèse vocale (alimenté par l’installateur).
AIHUMMER_VIDEO_URL URL secondaire pour la compréhension vidéo.
AIHUMMER_TTS_AUTO_REPLY Quand une réponse terminée est lue : off, always, inbound (par défaut), tagged.
AIHUMMER_TTS_MAX_CHARS Limite du texte lu : 0 — la réponse entière, sinon 100–10000 caractères.
AIHUMMER_TTS_SUMMARIZE Raccourcir une réponse longue pour la lecture (activé par défaut).

Les sidecars sont des services HTTP séparés ; la passerelle y accède par URL.

Vecteurs et embeddings

Clé But
AIHUMMER_QDRANT_URL Véritable magasin de vecteurs (Qdrant). Absent → magasin en mémoire.
AIHUMMER_EMBEDDER_URL Service d’intégration réel. Absent → intégrateur de hachage.

Surfaces de protocole (optionnelles)

Clé But
AIHUMMER_MCP_PUBLISH Exactement 1 ouvre le serveur MCP externe sur POST /v1/mcp. À lui seul, il n’exporte aucun outil.
AIHUMMER_MCP_EXPORT_TOOLS Noms exacts des outils, séparés par des virgules, que verra le client MCP. Vide (valeur par défaut) = ZÉRO outil exporté.
AIHUMMER_A2A_PUBLISH 1 active la surface A2A (/.well-known/agent.json, /a2a/message).

Construction développeur uniquement

Variable But
AIHUMMER_PLUGIN_PUBKEY Une clé publique fiable supplémentaire (ed25519 en base64) pour vérifier les signatures des plugins. Uniquement pour les builds de développement — ignoré dans les builds de production (la clé de registre est épinglée dans le binaire).
AIHUMMER_PLUGIN_DEV_UNSIGNED 1 permet d’installer non signé extensions. Uniquement pour les versions de développement — ignoré dans les versions finales. Jamais sur une instance accessible de l’extérieur.

[!WARNING] Dans les versions de production, la racine de confiance du plugin est intégré dans le binaire et ne peut pas être modifié par l’environnement ou les paramètres — il s’agit d’une protection contre la falsification garantie.

Le modèle de confiance (officiel → clé épinglée, privé → magasin de confiance, non signé → bloqué) est décrit dans Installation et mises à jour.

Où aller ensuite