Référence CLI

sudo aihummer up
aihummer status

# Only check whether a newer release exists
aihummer update --check

# Apply the update
sudo aihummer update

sudo aihummer restart
aihummer logs                 # the gateway unit's journal (default; follows)
aihummer logs --no-follow     # print the tail of the journal and exit
aihummer logs aihummer-stt    # another systemd unit's journal
sudo aihummer stop

aihummer doctor

aihummer backup /var/backups/aihummer
aihummer restore /var/backups/aihummer/aihummer-2026-07-05.sql

sudo aihummer set-password --login admin

aihummer settings set AIHUMMER_STT_URL http://127.0.0.1:8001
aihummer settings get AIHUMMER_STT_URL
aihummer settings list

aihummer license keygen                # generate a signing key
aihummer license sign                  # sign a license
aihummer license show <token>          # decode + verify a token

aihummer loadtest

aihummer plugin init <kind>            # scaffold a manifest (connector|service|openapi|mcp)
aihummer plugin validate manifest.json # validate a manifest against the contract
aihummer plugin keygen                 # ed25519 author key (.key + .pub)
aihummer plugin package ./my-plugin    # build a tarball + .sha256
aihummer plugin sign --key author.key --manifest ./my-plugin/manifest.json my-plugin-1.0.0.tar.gz

# Publish privately to your instance (public publishing is done in the portal — "My plugins")
aihummer plugin publish --private --instance https://host --token <admin> my-plugin-1.0.0.tar.gz

Le `aihummer` L'outil en ligne de commande gère une installation native sur l'hôte : il démarre et met à jour la passerelle (l'installation elle-même se fait via le lien d'installation personnel depuis votre portail de compte), contrôle le service systemd de la passerelle, exécute des diagnostics, gère les sauvegardes, lit et écrit les paramètres du plan de contrôle, et signe les licences. Cette page répertorie chaque commande. ## Commandes | Commande | Ce que cela fait | |---|---| | `up` / `install` | Démarrez le service systemd de la passerelle (`systemctl start`). Il n'installe rien — l'installation est effectuée par le script d'installation depuis votre lien personnel. | | `update [--check]` | Mettez à jour vers la dernière version (vérifiez la signature + remplacez le binaire + redémarrez); `--check` ne fait que signaler si une mise à jour est disponible. | | `restart` | Redémarrez le service de passerelle (`systemctl restart`). | | `stop` | Arrêtez le service passerelle (`systemctl stop`). | | `logs [unit] [--no-follow]` | Suivre le journal d'une unité systemd (`journalctl -u`); par défaut sur l'unité passerelle. `--no-follow` affiche la fin du journal puis quitte ; sans lui, la commande continue de suivre. | | `status` | Vue d'ensemble de l'installation, état des services et disponibilité de la passerelle (`/readyz`). Une section **Composants** rapporte l'état des unités sidecar optionnelles (recherche, navigateur, voix vers texte, texte vers voix, vidéo) ; quand `systemctl` est indisponible, elle dit honnêtement que l'état est inconnu au lieu de « non installé ». | | `doctor` | Diagnostics avec trois verdicts : tout va bien, en fonctionnement avec avertissements (N), ou problèmes détectés. Les vérifications de Node.js et du matériel d'enregistrement de flotte sont des avertissements, pas des échecs. | | `backup [dir]` | `pg_dump` l'état plan de PostgreSQL vers un fichier ; un répertoire par défaut est utilisé lorsqu'il est omis. | | `restore <file>` | Restaurer PostgreSQL à partir d'un fichier de sauvegarde produit par `backup`. | | `uninstall [flags]` | Supprimez l'installation (voir les options ci-dessous). Nécessite les droits root — exécutez-le avec `sudo`. | | `set-password` / `admin-password` | Définir/générer le mot de passe administrateur local (`[--login admin] [--password X]`). | | `settings {set\|get\|list}` | Lire/écrire les paramètres du plan de contrôle dans la base de données — c'est ainsi que les boutons du catalogue de paramètres sont configurés depuis l'interface en ligne de commande au lieu de `gateway.env`. | | `license {keygen\|sign\|show <token>}` | Gérer les licences : générer une clé, signer, décoder + vérifier un token donné. | | `loadtest` | Effectuez un test de charge contre la passerelle. | | `plugin {init\|validate\|keygen\|package\|sign\|publish}` | SDK de plugin : structurer, valider, clés, paquet, signer et publier. | | `version` | Imprime la version. | | `help` | Afficher l'aide. | ### `uninstall` drapeaux | Drapeau | Effet | |---|---| | `--purge` | Supprimez également les données (suppression complète). | | `--yes` | Ignorer l'invite de confirmation. | | `--no-backup` | Ne faites pas de sauvegarde avant de supprimer. | | `--backup-dir <dir>` | Écrivez la sauvegarde avant désinstallation dans ce répertoire. | ## Exemples d'utilisation ### Installer et démarrer L'installation se fait via le lien d'installation personnel depuis votre portail de compte (voir [Installation](/fr/v1.0/getting-started/installation)); après cela, l'interface en ligne de commande démarre et vérifie le service : ```bash sudo aihummer up aihummer status ``` ### Mettre à jour ```bash # Only check whether a newer release exists aihummer update --check # Apply the update sudo aihummer update ``` ### Contrôle et journaux de service Les commandes agissent sur l'unité systemd de passerelle unique (`AIHUMMER_SERVICE`, par défaut `aihummer-gateway`); `logs` accepte n'importe quel nom d'unité systemd. ```bash sudo aihummer restart aihummer logs # the gateway unit's journal (default; follows) aihummer logs --no-follow # print the tail of the journal and exit aihummer logs aihummer-stt # another systemd unit's journal sudo aihummer stop ``` ### Diagnostics ```bash aihummer doctor ``` ### Sauvegarder et restaurer `backup` court un `pg_dump` de l'état du plan PostgreSQL dans un fichier ; `restore` prend ce fichier de vidage. ```bash aihummer backup /var/backups/aihummer aihummer restore /var/backups/aihummer/aihummer-2026-07-05.sql ``` > [!TIP] > Postgres est la source de vérité, mais votre `AIHUMMER_MASTER_KEY` et la masse > le répertoire doit être sauvegardé séparément — sans la clé principale, chiffré > les secrets ne peuvent pas être récupérés. ### Définir le mot de passe administrateur La commande accepte `[--login admin] [--password X]` et besoins `AIHUMMER_DATABASE_URL` — normalement récupéré de `gateway.env` lorsqu'exécuté en tant qu'utilisateur d'installation ou via `sudo`. ```bash sudo aihummer set-password --login admin ``` ### Paramètres du plan de contrôle `settings` lit et écrit directement les boutons du catalogue des Paramètres dans la base de données — le même magasin que l'interface web d'administration (Gestion → Paramètres) modifie. Voici comment les boutons du catalogue sont configurés depuis le CLI : `gateway.env` les valeurs sont ignorées pour eux. ```bash aihummer settings set AIHUMMER_STT_URL http://127.0.0.1:8001 aihummer settings get AIHUMMER_STT_URL aihummer settings list ``` `settings list` affiche uniquement les clés du catalogue visibles par l'utilisateur (les clés système et internes sont cachées) ; chaque clé est marquée avec sa source — `[db]` pour les valeurs que vous définissez, `[unset]` avec le catalogue par défaut sinon. ### Licences `license show` nécessite un `<token>` argument et le `AIHUMMER_LICENSE_PUBKEY` variable : il décode et vérifie le **donné** jeton — il n'affiche pas la licence actuelle de l'instance. ```bash aihummer license keygen # generate a signing key aihummer license sign # sign a license aihummer license show <token> # decode + verify a token ``` ### Test de charge ```bash aihummer loadtest ``` ### Modules ```bash aihummer plugin init <kind> # scaffold a manifest (connector|service|openapi|mcp) aihummer plugin validate manifest.json # validate a manifest against the contract aihummer plugin keygen # ed25519 author key (.key + .pub) aihummer plugin package ./my-plugin # build a tarball + .sha256 aihummer plugin sign --key author.key --manifest ./my-plugin/manifest.json my-plugin-1.0.0.tar.gz # Publish privately to your instance (public publishing is done in the portal — "My plugins") aihummer plugin publish --private --instance https://host --token <admin> my-plugin-1.0.0.tar.gz ``` Pour le SDK complet, et pour publier sur le catalogue partagé depuis le portail («Mes plugins»), voir [SDK de plugin](/fr/v1.0/marketplace/sdk) et [Publier un plugin](/fr/v1.0/marketplace/publishing). > [!WARNING] > `uninstall` nécessite les droits root : exécuter `sudo aihummer uninstall`. Et > `sudo aihummer uninstall --purge --yes` supprime les données et ignore le > invite de confirmation — assurez-vous d'abord d'avoir une sauvegarde vérifiée. ## Environnement Les variables `aihummer` l'outil lui-même lit : | Variable | But | |---|---| | `AIHUMMER_SERVICE` | Le nom de l'unité systemd de la passerelle (par défaut `aihummer-gateway`) — la cible de `up`/`restart`/`stop`/`logs`. | | `AIHUMMER_GATEWAY_URL` | URL de passerelle pour `status`/`doctor`/`loadtest` (par défaut `http://127.0.0.1:8780`). | | `AIHUMMER_DATABASE_URL` | DSN Postgres — requis par `backup`/`restore`/`set-password`/`settings`. | | `AIHUMMER_LANG` | Langue de la sortie et de l'aide de la CLI : `ru` (par défaut) ou `en`. | La plupart des commandes nécessitent les privilèges root (`systemctl`) — exécutez-les avec `sudo`. ## Où aller ensuite - Configurez l'instance : [Variables d'environnement](/fr/v1.0/reference/env-vars). - Décidez quels outils l'agent peut utiliser : [Catalogue d'outils](/fr/v1.0/reference/tools-catalog).