Guía para workers
Un worker es la app de escritorio que sirve tus modelos de Ollama locales. Ejecutar uno es un clic dentro de la app; no hay CLI ni cuenta.
Requisitos
- macOS 13+ (Apple Silicon o Intel) o Windows 11.
- Ollama: la app lo instala y lo supervisa si falta.
- Una billetera en Base Sepolia. El USDC de prueba viene del faucet y no tiene valor.
- Disco para los modelos que elijas (un 7B ocupa unos 4–5 GB).
1. Instalar y arrancar
Abre la app, elige Ejecutar un worker y deja que instale o se conecte a Ollama. La app arranca Ollama, descarga el modelo si hace falta y muestra una tarjeta de estado cuando el worker está listo.
2. Elegir modelos
Solo se listan los modelos que Ollama puede servir localmente. Un worker sirve un modelo por oferta; puedes crear varias ofertas si tienes disco y VRAM.
3. Fijar tu precio
El precio es una tarifa por hora que escribes tú. No hay precio sugerido y la app nunca lo baja. El cobro se acumula por minuto iniciado:
| Tarifa | Pago por un trabajo de 2 minutos |
|---|---|
| 6 USDC / hora | 0.2 USDC |
| 30 USDC / hora | 1.0 USDC |
4. Registrarse
El registro escribe tu peer ID y tu policy hash en WorkerRegistry. Cuesta gas en Base Sepolia.
Volver a registrarse conserva la fecha de registro original.
5. Alcanzabilidad
Antes de servir, la app comprueba si otros pares pueden alcanzarte de verdad. Un NAT simétrico sin relay, un puerto de entrada bloqueado o una red de campus que filtra IPv6 de entrada harán fallar la comprobación.
- IPv6 es opcional. La app no depende de él por defecto.
- Los relays son solo para el handshake. No sirven para una sesión completa.
- El localizador público es opcional. Publicar tu IP es permanente y no se deshace borrando la app.
6. Ganar y retirar
Las sesiones liquidadas se acumulan en tu billetera de worker. Llama a claim() en la app para mover
el saldo fuera de JobEscrow. La tesorería toma el 1%; tú conservas el 99%.
Solución de problemas
| Síntoma | Causa probable |
|---|---|
| Se registra pero no llegan sesiones | Falló la alcanzabilidad; revisa NAT y firewall |
| Ollama corre pero la app dice offline | Ollama escucha en 127.0.0.1 en un puerto que la app no espera |
| La sesión se abre y se reembolsa | El worker no firmó el recibo antes del tiempo límite |
| El saldo no se mueve | La liquidación es por sesión; claim() es un paso aparte |
Qué envía la app
El reporte de uso está desactivado. La app habla con la cadena por un RPC público, con los workers por libp2p y con GitHub Releases para actualizarse. No envía prompts, nombres de archivo ni nombres de modelos a GenKaKu Labs.