CLI-Referenz

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

Der `aihummer` Das Kommandozeilen-Tool verwaltet eine host-native Installation: Es startet und aktualisiert das Gateway (die Installation selbst erfolgt über den persönlichen Installationslink aus Ihrem Konto-Portal), steuert den Gateway-Systemd-Dienst, führt Diagnosen durch, verwaltet Backups, liest und schreibt Einstellungen der Steuerungsebene und signiert Lizenzen. Diese Seite listet jeden Befehl auf. ## Befehle | Befehl | Was es tut | |---|---| | `up` / `install` | Starten Sie den Gateway-Systemd-Dienst (`systemctl start`). Es wird nichts installiert — die Installation erfolgt durch das Installationsskript von Ihrem persönlichen Link. | | `update [--check]` | Auf die neueste Version aktualisieren (Signatur überprüfen + Binärdatei austauschen + neu starten); `--check` meldet nur, ob ein Update verfügbar ist. | | `restart` | Starten Sie den Gateway-Dienst neu (`systemctl restart`). | | `stop` | Stoppen Sie den Gateway-Dienst (`systemctl stop`). | | `logs [unit] [--no-follow]` | Verfolge das Journal einer systemd-Einheit (`journalctl -u`); standardmäßig auf die Gateway-Einheit. `--no-follow` gibt das Ende des Journals aus und beendet sich; ohne das Flag folgt der Befehl weiter. | | `status` | Überblick über die Installation, Zustand der Dienste und Bereitschaft des Gateways (`/readyz`). Ein Abschnitt **Komponenten** meldet den Zustand der optionalen Sidecar-Einheiten (Suche, Browser, Sprache-zu-Text, Text-zu-Sprache, Video); ist `systemctl` nicht verfügbar, sagt er ehrlich, dass der Zustand unbekannt ist, statt „nicht installiert". | | `doctor` | Diagnose mit drei Urteilen: alles in Ordnung, läuft mit Warnungen (N) oder Probleme gefunden. Die Prüfungen für Node.js und das Flottenregistrierungs-Material sind Warnungen, keine Fehlschläge. | | `backup [dir]` | `pg_dump` die PostgreSQL-Zustandsebene in eine Datei; ein Standardverzeichnis wird verwendet, wenn es weggelassen wird. | | `restore <file>` | PostgreSQL aus einer von ... erzeugten Dump-Datei wiederherstellen `backup`. | | `uninstall [flags]` | Entfernen Sie die Installation (siehe unten stehende Flags). Benötigt Root — führen Sie es aus mit `sudo`. | | `set-password` / `admin-password` | Legen Sie das lokale Admin-Passwort fest/generieren (`[--login admin] [--password X]`). | | `settings {set\|get\|list}` | Lese-/Schreibsteuerungsebeneneinstellungen in der Datenbank – so werden die Einstellungen des Einstellungen-Katalogs über die CLI konfiguriert anstatt `gateway.env`. | | `license {keygen\|sign\|show <token>}` | Lizenzen verwalten: einen Schlüssel erzeugen, signieren, einen gegebenen Token decodieren und überprüfen. | | `loadtest` | Führe einen Lasttest gegen das Gateway durch. | | `plugin {init\|validate\|keygen\|package\|sign\|publish}` | Plugin-SDK: Gerüst erstellen, validieren, Schlüssel, Paket, signieren und veröffentlichen. | | `version` | Drucke die Version. | | `help` | Hilfe anzeigen. | ### `uninstall` Flaggen | Flagge | Effekt | |---|---| | `--purge` | Entfernen Sie daher auch die Daten (vollständige Entfernung). | | `--yes` | Die Bestätigungsaufforderung überspringen. | | `--no-backup` | Machen Sie kein Backup, bevor Sie es entfernen. | | `--backup-dir <dir>` | Schreiben Sie das Backup vor der Deinstallation in dieses Verzeichnis. | ## Beispielanwendungen ### Installieren und hochfahren Die Installation erfolgt über den persönlichen Installationslink aus Ihrem Kontobereich (siehe [Installation](/de/v1.0/getting-started/installation)); danach startet die CLI und überprüft den Dienst: ```bash sudo aihummer up aihummer status ``` ### Aktualisieren ```bash # Only check whether a newer release exists aihummer update --check # Apply the update sudo aihummer update ``` ### Dienststeuerung und Protokolle Die Befehle wirken auf die einzelne Gateway-Systemd-Einheit (`AIHUMMER_SERVICE`, Standard `aihummer-gateway`); `logs` akzeptiert jeden systemd-Einheitennamen. ```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 ``` ### Diagnostik ```bash aihummer doctor ``` ### Sichern und Wiederherstellen `backup` führt ein `pg_dump` des PostgreSQL-Staatsplans in eine Datei; `restore` nimmt diese Dump-Datei. ```bash aihummer backup /var/backups/aihummer aihummer restore /var/backups/aihummer/aihummer-2026-07-05.sql ``` > [!TIP] > Postgres ist die Quelle der Wahrheit, aber Ihre `AIHUMMER_MASTER_KEY` und der Blob > Das Verzeichnis muss separat gesichert werden — ohne den Hauptschlüssel, verschlüsselt > Geheimnisse können nicht wiederhergestellt werden. ### Legen Sie das Administratorpasswort fest Der Befehl akzeptiert `[--login admin] [--password X]` und Bedürfnisse `AIHUMMER_DATABASE_URL` — normalerweise aufgenommen von `gateway.env` wenn als Installationsbenutzer oder über ausgeführt `sudo`. ```bash sudo aihummer set-password --login admin ``` ### Steuerungsebene-Einstellungen `settings` liest und schreibt Einstellungs-Katalog-Regler direkt in der Datenbank — dasselbe Speicher, das die Web-Admin-Oberfläche (Verwaltung → Einstellungen) bearbeitet. So werden Katalog-Regler von der CLI aus konfiguriert: `gateway.env` Werte werden für sie ignoriert. ```bash aihummer settings set AIHUMMER_STT_URL http://127.0.0.1:8001 aihummer settings get AIHUMMER_STT_URL aihummer settings list ``` `settings list` zeigt nur die benutzerseitigen Katalogschlüssel (System- und interne Schlüssel sind ausgeblendet); jeder Schlüssel ist mit seiner Quelle gekennzeichnet — `[db]` für die Werte, die Sie einstellen, `[unset]` ansonsten mit dem Standard des Katalogs. ### Lizenzen `license show` erfordert ein `<token>` Argument und das `AIHUMMER_LICENSE_PUBKEY` Variable: sie decodiert und überprüft die **gegeben** Token — es zeigt die aktuelle Lizenz der Instanz nicht an. ```bash aihummer license keygen # generate a signing key aihummer license sign # sign a license aihummer license show <token> # decode + verify a token ``` ### Belastungstest ```bash aihummer loadtest ``` ### Plugins ```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 ``` Für das vollständige SDK und für die Veröffentlichung im gemeinsamen Katalog über das Portal («Meine Plugins») siehe [Plugin-SDK](/de/v1.0/marketplace/sdk) und [Ein Plugin veröffentlichen](/de/v1.0/marketplace/publishing). > [!WARNING] > `uninstall` erfordert Root: ausführen `sudo aihummer uninstall`. Und > `sudo aihummer uninstall --purge --yes` entfernt Daten und überspringt die > Bestätigungsaufforderung — stellen Sie zuerst sicher, dass Sie ein verifiziertes Backup haben. ## Umwelt Variablen die `aihummer` das Werkzeug selbst liest: | Variable | Zweck | |---|---| | `AIHUMMER_SERVICE` | Der Gateway-Systemd-Diensteinheit-Name (Standard `aihummer-gateway`) — das Ziel von `up`/`restart`/`stop`/`logs`. | | `AIHUMMER_GATEWAY_URL` | Gateway-URL für `status`/`doctor`/`loadtest` (Standard `http://127.0.0.1:8780`). | | `AIHUMMER_DATABASE_URL` | Postgres DSN — erforderlich für `backup`/`restore`/`set-password`/`settings`. | | `AIHUMMER_LANG` | Sprache der CLI-Ausgabe und -Hilfe: `ru` (Standard) oder `en`. | Die meisten Befehle benötigen Root (`systemctl`) — führe sie mit `sudo`. ## Wohin als Nächstes - Konfigurieren Sie die Instanz: [Umgebungsvariablen](/de/v1.0/reference/env-vars). - Entscheiden Sie, welche Werkzeuge der Agent verwenden kann: [Werkzeugkatalog](/de/v1.0/reference/tools-catalog).