Guía de la beta para vendedores

Te invitaron a la beta de vendedores de Gyblos. Esta guía te lleva desde los archivos de tu invitación hasta tener tu nodo listado en el descubrimiento. Toma unos 15 minutos, casi todo en descargas.

Qué necesitasCopiar enlace

• Tu invitación, con tres cosas:
  • install.sh, el script de instalación;
  • un token de relay, que permite que tu nodo llegue a los relays de Gyblos;
  • un código de invitación que empieza con gyb_ y se usa una sola vez para registrarte.
• Una máquina que quede encendida. Linux (x86-64 o ARM64) o macOS. Sirve un VPS pequeño.
• Docker con Compose v2.17 o más nuevo. En macOS, Docker Desktop. En Linux, Docker Engine con el plugin de compose y tu usuario en el grupo docker.
• Al menos 4 GB de memoria. El vendedor necesita 1,5 GB libres para arrancar, y el modelo corre al lado.
• Algunos GB de disco para las imágenes y el modelo.
• Salida a internet. No se abre ningún puerto: tu nodo se conecta hacia afuera, a los relays.

Mantén en privado el token de relay y el código de invitación. No los pegues en chats, issues ni capturas de pantalla.

InstalarCopiar enlace

sh install.sh

Seller identity (public; `gyblos seller register` enrolls it in discovery):
  nodeId  4d789a89…
  owner   7is91kWV…

Revisa que esté sirviendoCopiar enlace

Todos los comandos de aquí en adelante se corren desde la carpeta de instalación:

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

Mira la línea Result::

Si el comando mismo dice que el servicio no está corriendo o se está reiniciando, el vendedor se detuvo por un error: lee docker compose logs seller, corrige la causa y arráncalo con docker compose up -d.

Regístrate con tu invitaciónCopiar enlace

El registro permite que tu vendedor aparezca en el descubrimiento de Gyblos, donde lo encuentran los compradores. Usa tu código una vez:

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

Pega el código cuando te lo pida. Se ve en pantalla mientras lo pegas, así que hazlo donde nadie vea tu pantalla. Registered: this seller may now publish. significa que funcionó. Si lo vuelves a correr con el mismo código, responde Already registered.

El código queda ligado a las llaves de tu vendedor. Si las borras (docker compose down -v), el mismo código ya no funciona.

Publica tu ofertaCopiar enlace

Las instalaciones nuevas empiezan sin listarse. Cuando estés registrado, abre ~/gyblos-seller/gyblos.toml y cambia:

[discovery]
publish = true

Aplica el cambio:

cd ~/gyblos-seller
docker compose up -d --force-recreate seller

Después de un minuto, revisa que el descubrimiento te liste:

docker compose exec seller gyblos seller status --online

Debería decir listed in the index.

Qué ofrece tu nodoCopiar enlace

La oferta por defecto en gyblos.toml regala qwen3:0.6b:

• hasta 200.000 tokens al día en total;
• hasta 5.000 tokens al día por cada comprador.

Los contadores se reinician cuando el vendedor se reinicia. Puedes bajar estos límites en la sección [[offers]]. Aplica los cambios con docker compose up -d --force-recreate seller.

Los prompts se procesan en tu máquina, así que tu nodo puede leerlos. No guardes ni compartas lo que envían los compradores. El descubrimiento publica tu nodeId, tu owner, tu modelo y un precio cero.

Comandos del día a díaCopiar enlace

Desde ~/gyblos-seller:

Al detenerlo, tu oferta sale del descubrimiento en menos de dos minutos.

Solución de problemasCopiar enlace

Si te quedas atascado, envía al equipo de Gyblos lo que muestra docker compose exec seller gyblos seller status. Nunca incluye tu token de relay ni tus llaves.