CLI

Esta referencia enumera los comandos implementados de gyblos. En la instalación de Docker por invitación, ejecútalos desde ~/gyblos-seller con el prefijo docker compose exec seller. Si el contenedor no está disponible, usa docker compose run --rm seller antes de gyblos. En un checkout nativo se usa pnpm gyblos; no sustituye la instalación de Docker.

ComandosCopiar enlace

No hay comandos generales gyblos start ni gyblos stop, ni opciones generales --home, --relay, --rpc-url o --discovery-url en la CLI. Usa Compose para el ciclo de vida de Docker y las variables documentadas para las modificaciones admitidas.

Comandos de DockerCopiar enlace

ValidaciónCopiar enlace

cd ~/gyblos-seller
docker compose run --rm seller gyblos config validate --config /config/gyblos.toml

Si es correcto muestra OK, los ajustes efectivos y su origen, las ofertas y los nombres de variables secretas con set o not set. Si falla muestra códigos y rutas de claves. Oculta los valores del entorno; las URLs del archivo o predeterminadas se reducen al origen y ocultan las rutas. Revisa aun así la salida personalizada. El comando analiza el archivo y resuelve el entorno; no comprueba que el motor esté listo ni todas las restricciones de inicio del vendedor.

DiagnósticoCopiar enlace

cd ~/gyblos-seller
docker compose run --rm seller gyblos doctor

Doctor muestra OK, WARN o FAIL con códigos y consejos, límites efectivos e identidad pública. No inicia el vendedor, genera inferencia ni escribe estado. Consulta los motores de loopback. --online añade consultas a listas de modelos remotos y al reloj de descubrimiento; puede enviar credenciales al proveedor configurado. Una consulta correcta no demuestra generación, margen de memoria ni integridad del contenido de las llaves privadas. Consulta solución de problemas si falla.

Estado y registroCopiar enlace

cd ~/gyblos-seller
docker compose exec seller gyblos seller status
docker compose exec seller gyblos seller status --online
docker compose exec seller gyblos seller register

Status es de solo lectura. --online consulta descubrimiento por modelo para buscar el NodeId público. Su resumen de actividad es un historial limitado de recibos conservados, no un saldo de cuotas.

Register recibe la invitación por terminal interactiva o GYBLOS_INVITE, nunca como argumento de línea de comandos. La entrada interactiva es visible. Concede permiso para publicar cuando el índice verifica la inscripción. Con terminal interactiva puede crear la inscripción devnet usando la cartera owner: estima el coste, simula y pide yes antes de un nuevo envío firmado. Escribe estado privado y al repetir puede reenviar una transacción guardada ya aprobada sin otra pregunta. No cambia TOML ni publica. REGISTER_IDENTITY_UNAVAILABLE indica una inscripción no completada; lee el consejo sobre fondos, simulación o estado incierto. Consulta Registra y publica para conocer requisitos y límites de recuperación antes de ejecutarlo.

Checkout nativoCopiar enlace

InitCopiar enlace

gyblos seller init escribe una oferta gratuita en devnet. No instala Docker, crea llaves, descarga modelos ni inicia motores. En Docker edita el archivo del anfitrión: el montaje del contenedor es de solo lectura.

En terminal pregunta las opciones que faltan; los scripts usan opciones y valores predeterminados. Sin --force rechaza un archivo existente. Init comprueba los ajustes con una credencial de ejemplo; no valida la credencial real. Su puerto nativo de Ollama 11435 difiere del 11434 del instalador de Docker.

Servicios en segundo planoCopiar enlace

Estos comandos usan systemd de usuario en Linux o launchd en macOS, no Docker. Ejecútalos con la cuenta vendedora, nunca como root. Install usa 2048M de memoria por defecto, también el mínimo, y 100% de CPU. --dry-run permite previsualizar sin instalar. macOS no aplica estos límites de recursos.

El servicio nativo usa el seller.env de su directorio de datos, con líneas estrictas NAME=value y permisos solo para el propietario; no hereda todas las variables de tu terminal. Captura las rutas de datos y configuración al instalarse. Uninstall elimina el registro del servicio, no las llaves ni la configuración. El aprovisionamiento nativo está fuera del tutorial de Docker; no ejecutes service install dentro del contenedor.

Relacionado: Configuración · Operación.