Configuración

Edita ~/gyblos-seller/gyblos.toml en el anfitrión. La imagen suministrada lo monta en modo de solo lectura en /config/gyblos.toml y lo selecciona mediante GYBLOS_CONFIG. Se lee al arrancar; los cambios requieren recrear.

EjemploCopiar enlace

version = 1

[node]
network = "devnet"

[discovery]
publish = false

[[offers]]
model = "qwen3:0.6b"
reasoning = ["off"]
engine = { kind = "ollama", url = "http://127.0.0.1:11434/" }
free = { daily_token_cap = 200000, per_buyer_cap = 50000 }

Es una oferta local gratuita sin publicar. Conserva tu elección de publicación al editar otro ajuste. Para cambiar cuotas, consulta Modelos y ofertas.

Valida y aplicaCopiar enlace

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

Espera OK; corrige cada código y ruta de clave antes de aplicar. Después:

docker compose up -d --force-recreate seller
docker compose exec seller gyblos seller status

config validate revisa el esquema y el entorno; doctor revisa compatibilidad con el inicio del vendedor y consulta dependencias. Un archivo válido no demuestra que un modelo pueda servir. Si lo necesitas, ejecuta docker compose run --rm seller gyblos doctor antes de recrear.

OpcionesCopiar enlace

La versión 1 del esquema exige version = 1 y [node] network = "devnet". Las claves desconocidas fallan. El archivo tiene un límite de 64 KiB. Los conteos deben ser enteros TOML, no decimales ni números entre comillas. Mainnet se rechaza con MAINNET_UNSUPPORTED. El esquema admite más ajustes de los que consume este vendedor.

Conserva la ruta /data y la conexión al volumen de la imagen de Docker. El directorio nativo predeterminado es .local/gyblos, relativo al directorio de trabajo; cambiarlo selecciona otro estado de identidad. No cambies de ruta para reparar una identidad ausente.

CapacidadCopiar enlace

Todas las claves de [limits] son enteros opcionales, mínimo 1, solo en archivo:

El producto efectivo max_connections × requests_per_minute no puede superar global_requests_per_minute, incluidos los valores predeterminados omitidos. Doctor muestra los límites efectivos de capacidad. Son independientes de las cuotas de tokens de las ofertas.

Una solicitud es una respuesta que pide el comprador. La cotización, el catálogo y los recibos que la acompañan no cuentan, así que 30 por minuto son 30 respuestas por comprador.

OfertasCopiar enlace

El vendedor necesita al menos una entrada [[offers]]; se admiten hasta 32. Cada modelo normalizado puede aparecer una vez, incluidos sus alias. Todas las entradas deben superar las comprobaciones del motor; al menos un motor debe quedar listo para iniciar y solo se publican las ofertas listas.

Se exige exactamente uno entre free y price. Los contadores gratuitos se restablecen al reiniciar; no persisten. El esquema general admite price.input_per_mtok y price.output_per_mtok como cadenas decimales en USDC por millón de tokens, con price.currency = "USDC". Al menos una tarifa debe ser positiva; sin signos, exponentes ni ceros iniciales; hasta cuatro dígitos enteros y seis decimales tras quitar ceros finales. Este tutorial aprovisiona un rol vendedor solo gratuito. Las ofertas pagadas requieren preparar por separado el rol de pagos en devnet; aceptar price no aprovisiona esos roles ni demuestra preparación para pagos.

MotoresCopiar enlace

• Ollama: Qwen3 0.6B fijado, razonamiento off, URL raíz de loopback literal, sin variable de API key. La URL de Docker es http://127.0.0.1:11434/. localhost o host.docker.internal pueden pasar el esquema y fallar en el motor.
• Compatible con OpenAI: razonamiento off, contexto explícito, URL HTTPS o loopback literal, normalmente terminada en /v1. Desactiva razonamiento en el proveedor. Una variable de key nombrada debe existir y no estar vacía.
• Compatible con Anthropic: razonamiento off, contexto y variable de API key no vacía. Usa la raíz sin /v1; el proveedor debe admitir consulta de modelos y Messages.

El uso de otros modelos es declarado por el proveedor, no recontado de forma independiente con el tokenizador fijado de Qwen. Los proveedores remotos pueden cobrar y recibir datos de compradores aunque tu oferta sea gratuita.

EntornoCopiar enlace

Para los ajustes del vendedor, el entorno prevalece sobre el archivo y después se aplican los valores predeterminados. El resolutor general también tiene opciones programáticas, pero no son opciones generales de la CLI. Compose pasa el entorno del contenedor; definir una variable solo en tu terminal anfitriona no la envía automáticamente.

Los valores vacíos de home, escucha y dirección externa se ignoran. [limits], ofertas y telemetría no tienen modificación por entorno. Después de editar seller.env, recrea el contenedor para cargar el cambio.

Secretos y erroresCopiar enlace

Usa nombres *_env en TOML, nunca credenciales. Los nombres usan mayúsculas, dígitos y guiones bajos y no pueden empezar por dígito. Guarda credenciales solo en el archivo privado de entorno; no reutilices el token de relay como key de proveedor. Se rechazan campos de credenciales en línea y queries de URL con credenciales, pero una credencial en la ruta puede escapar a la detección. Revisa antes de compartir.

Entre los códigos del archivo están TOML_SYNTAX, UNKNOWN_KEY, WRONG_TYPE, INLINE_SECRET, INVALID_CAP, INVALID_LIMIT, RELAY_ONLY_CONFLICT y REASONING_UNSUPPORTED. Avisos como ENV_SWITCH_NOT_STRICT y REASONING_UNVERIFIED no hacen fallar la validación. El inicio puede rechazar además ajustes, motores o razonamiento no admitidos, o keys ausentes. Consulta solución de problemas.

Relacionado: CLI · Modelos y ofertas.