Referencia de 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

la `aihummer` La herramienta de línea de comandos gestiona una instalación nativa en el host: inicia y actualiza la puerta de enlace (la instalación en sí se realiza a través del enlace de instalación personal desde su portal de cuenta), controla el servicio systemd de la puerta de enlace, ejecuta diagnósticos, maneja copias de seguridad, lee y escribe configuraciones del plano de control, y firma licencias. Esta página enumera todos los comandos. ## Comandos | Comando | Lo que hace | |---|---| | `up` / `install` | Inicie el servicio systemd de la puerta de enlace (`systemctl start`). No instala nada — la instalación la realiza el script de instalación desde tu enlace personal. | | `update [--check]` | Actualiza a la última versión (verifica la firma + cambia el binario + reinicia); `--check` solo informa si hay una actualización disponible. | | `restart` | Reiniciar el servicio de puerta de enlace (`systemctl restart`). | | `stop` | Detener el servicio de puerta de enlace (`systemctl stop`). | | `logs [unit] [--no-follow]` | Seguir el diario de una unidad systemd (`journalctl -u`); por defecto, a la unidad de puerta de enlace. `--no-follow` imprime la cola del diario y sale; sin él, el comando sigue el diario. | | `status` | Resumen de la instalación, estado de los servicios y preparación de la puerta de enlace (`/readyz`). Una sección **Componentes** informa del estado de las unidades sidecar opcionales (búsqueda, navegador, voz a texto, texto a voz, vídeo); cuando `systemctl` no está disponible, dice honestamente que el estado es desconocido en lugar de «no instalado». | | `doctor` | Diagnóstico con tres veredictos: todo bien, funcionando con advertencias (N) o problemas encontrados. Las comprobaciones de Node.js y del material de registro de flota son advertencias, no fallos. | | `backup [dir]` | `pg_dump` el plano estatal de PostgreSQL a un archivo; se utiliza un directorio predeterminado cuando se omite. | | `restore <file>` | Restaurar PostgreSQL desde un archivo de volcado producido por `backup`. | | `uninstall [flags]` | Elimina la instalación (ver las banderas a continuación). Requiere root: ejecútalo con `sudo`. | | `set-password` / `admin-password` | Establecer/generar la contraseña de administrador local (`[--login admin] [--password X]`). | | `settings {set\|get\|list}` | Leer/escribir configuraciones del plano de control en la base de datos: así es como se configuran los controles del catálogo de Configuraciones desde la CLI en lugar de `gateway.env`. | | `license {keygen\|sign\|show <token>}` | Administrar licencias: generar una clave, firmar, decodificar y verificar un token dado. | | `loadtest` | Realiza una prueba de carga contra la puerta de enlace. | | `plugin {init\|validate\|keygen\|package\|sign\|publish}` | SDK de plugins: crear estructura, validar, claves, empaquetar, firmar y publicar. | | `version` | Imprime la versión. | | `help` | Mostrar ayuda. | ### `uninstall` banderas | Bandera | Efecto | |---|---| | `--purge` | También eliminar datos (eliminación completa). | | `--yes` | Omitir el mensaje de confirmación. | | `--no-backup` | No haga una copia de seguridad antes de eliminar. | | `--backup-dir <dir>` | Escriba la copia de seguridad previa a la desinstalación en este directorio. | ## Ejemplos de uso ### Instalar y poner en marcha La instalación se realiza a través del enlace de instalación personal desde su portal de cuenta (ver [Instalación](/es/v1.0/getting-started/installation)); después de eso, la CLI se inicia y verifica el servicio: ```bash sudo aihummer up aihummer status ``` ### Actualizar ```bash # Only check whether a newer release exists aihummer update --check # Apply the update sudo aihummer update ``` ### Control de servicio y registros Los comandos actúan sobre la unidad systemd de puerta de enlace única (`AIHUMMER_SERVICE`, por defecto `aihummer-gateway`); `logs` acepta cualquier nombre de unidad de 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 ``` ### Diagnósticos ```bash aihummer doctor ``` ### Copia de seguridad y restauración `backup` corre una `pg_dump` del plano estatal de PostgreSQL a un archivo; `restore` toma ese archivo de volcado. ```bash aihummer backup /var/backups/aihummer aihummer restore /var/backups/aihummer/aihummer-2026-07-05.sql ``` > [!TIP] > Postgres es la fuente de la verdad, pero tu `AIHUMMER_MASTER_KEY` y la masa > el directorio debe respaldarse por separado — sin la clave maestra, cifrado > los secretos no pueden ser recuperados. ### Establecer la contraseña de administrador El comando acepta `[--login admin] [--password X]` y necesidades `AIHUMMER_DATABASE_URL` — normalmente recogido de `gateway.env` cuando se ejecuta como el usuario de instalación o vía `sudo`. ```bash sudo aihummer set-password --login admin ``` ### Configuraciones del plano de control `settings` lee y escribe directamente los controles del catálogo de Configuración en la base de datos, la misma tienda que edita la interfaz de administración web (Administración → Configuración). Así es como se configuran los controles del catálogo desde la CLI: `gateway.env` los valores se ignoran para ellos. ```bash aihummer settings set AIHUMMER_STT_URL http://127.0.0.1:8001 aihummer settings get AIHUMMER_STT_URL aihummer settings list ``` `settings list` muestra solo las claves del catálogo visibles para el usuario (las claves del sistema e internas están ocultas); cada clave está etiquetada con su fuente — `[db]` para los valores que establezcas, `[unset]` con el valor predeterminado del catálogo de lo contrario. ### Licencias `license show` requiere un `<token>` argumento y el `AIHUMMER_LICENSE_PUBKEY` variable: decodifica y verifica el **dada** token — no muestra la licencia actual de la instancia. ```bash aihummer license keygen # generate a signing key aihummer license sign # sign a license aihummer license show <token> # decode + verify a token ``` ### Prueba de carga ```bash aihummer loadtest ``` ### Complementos ```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 ``` Para el SDK completo, y para publicar en el catálogo compartido desde el portal («Mis complementos»), vea [SDK de complementos](/es/v1.0/marketplace/sdk) y [Publicando un complemento](/es/v1.0/marketplace/publishing). > [!WARNING] > `uninstall` requiere root: ejecutar `sudo aihummer uninstall`. Y > `sudo aihummer uninstall --purge --yes` elimina datos y omite el > mensaje de confirmación — asegúrate de tener una copia de seguridad verificada primero. ## Medio ambiente Las variables `aihummer` la herramienta misma lee: | Variable | Propósito | |---|---| | `AIHUMMER_SERVICE` | El nombre de la unidad systemd de la puerta de enlace (predeterminado `aihummer-gateway`) — el objetivo de `up`/`restart`/`stop`/`logs`. | | `AIHUMMER_GATEWAY_URL` | URL de puerta de enlace para `status`/`doctor`/`loadtest` (predeterminado `http://127.0.0.1:8780`). | | `AIHUMMER_DATABASE_URL` | DSN de Postgres — requerido por `backup`/`restore`/`set-password`/`settings`. | | `AIHUMMER_LANG` | Idioma de la salida y la ayuda de la CLI: `ru` (predeterminado) o `en`. | La mayoría de los comandos necesitan root (`systemctl`) — ejecútalos con `sudo`. ## ¿A dónde vamos ahora? - Configure la instancia: [Variables de entorno](/es/v1.0/reference/env-vars). - Decide qué herramientas puede usar el agente: [Catálogo de herramientas](/es/v1.0/reference/tools-catalog).