Ejecutar un worker
Un worker es un plugin de DeepSeek Harness que comparte los modelos ya instalados en esta máquina, al precio que tú fijes. Ejecuta Ollama localmente; no hay clave de API en la nube ni factura de inferencia por consumo.
Requisitos
- DeepSeek Harness
0.2.2-rc.1o posterior, y Node 22+. - Ollama con al menos un modelo descargado
(
ollama pull qwen3:8b, por ejemplo). - Una billetera de Solana con un poco de SOL para las comisiones. El plugin genera una por ti.
No hay token GenKaKu ni staking. Ganas USDC; gastas fracciones de céntimo de SOL en comisiones de red y rent.
Instalación
En DeepSeek Harness abre Plugins → Añadir plugin y pega:
@genkaku/dsh-worker-plugin
Deja la fuente de instalación en Registro predeterminado (registry.npmjs.org),
confirma y reinicia DeepSeek Harness. Lo mismo desde una shell:
dsh plugin add @genkaku/dsh-worker-plugin@0.5.0-rc.8
Esta implementación de vista previa publica una versión preliminar, así que el comando anterior indica la versión exacta 0.5.0-rc.8 en lugar de una etiqueta: una etiqueta no resuelve a esta compilación.
Aparece una entrada GenKaKu worker en la barra lateral.
Primer arranque
El plugin busca Ollama en http://127.0.0.1:11434 y arranca ollama serve por
su cuenta si está instalado pero no en ejecución. La primera sección del panel
muestra si Ollama está funcionando y cuántos modelos encontró.
Cuando el tablón de ofertas está vacío, el plugin lista todos los modelos locales
a defaultPricePerHour, que es 0 por defecto. Es algo deliberado: una máquina
cuyo dueño no ha fijado un precio no debería poner precio a su hardware.
Fijar un precio
Abre Modelos ofrecidos en el panel y asigna a cada modelo un precio por hora
en USDC, como entero con 6 decimales de precisión (así, 250000 es
0.25 USDC/hour). Déjalo en 0 para servir el modelo gratis.
- Un modelo de pago deposita USDC en un escrow por sesión y liquida con un recibo que el usuario conserva y que tú firmas.
- Un modelo gratuito se sirve sin tocar la cadena: sin sesión, sin comisión, sin transacción.
El cobro se acumula por minuto iniciado de una sesión, así que un trabajo de dos minutos paga dos minutos a la tarifa por hora, no una hora completa.
Tu tarifa de listado en la cadena es el modelo más caro que publicas, cotizado por minuto. Es un techo: toda sesión contra ti debe tener un precio igual o inferior. Si un cliente cotiza menos que el precio propio del modelo, tu sidecar rechaza la sesión antes de generar un token, así que nadie viaja barato en un modelo caro.
Nombre, visibilidad y emparejamiento
Name & access en el panel reúne tres cosas:
- Nombre visible: un nombre personal, un ID o un apodo. Los usuarios lo ven junto a tus modelos, pueden buscarlo y ordenar la lista por él. No se escribe en la cadena: allí solo están tu billetera, tu peer ID y tu localizador.
- Público / privado: público es lo predeterminado; el worker se une al directorio y a la semilla, y cualquiera puede marcarle. Privado lo saca de ambos. Su fila en la cadena sigue existiendo porque la liquidación paga a esa cuenta, pero la fila no lleva dirección, así que un desconocido no tiene nada que marcar.
- Códigos de emparejamiento: la única entrada a un worker privado. Pulsa
Generar código, y envía la cadena
genkaku1.…a quien quieras autorizar. Un código sirve una sola vez, caduca a los 15 minutos y solo se guarda como hash: perder el archivo no filtra un código utilizable.
El emparejamiento vincula la billetera de quien lo canjea, no la cadena. La clave de billetera del usuario es también su identidad libp2p, así que cada conexión posterior la autoriza el propio handshake del transporte: ninguna petición lleva un token, y un código robado no sirve desde otra máquina. Billeteras emparejadas muestra a quién está permitido; desemparejar quita a uno al instante y la siguiente conexión se rechaza.
Privado no significa gratis: pon un precio como siempre, y 0 sigue siendo
gratis. Un worker privado cobra por el mismo escrow que uno público.
Cambiar la visibilidad reinicia la mitad worker, porque la entrada del directorio y el anuncio a la semilla se deciden al arrancar.
Publicar en la cadena (opcional)
Esta sección se aplica a los workers públicos; uno privado nunca se lista.
El interruptor Directorio escribe tu peer ID, tu tarifa y tu localizador en el programa, para que los usuarios puedan encontrarte sin conocer tu dirección de antemano.
Está desactivado por defecto, y solo se activa cuando esta máquina tiene una dirección alcanzable globalmente. Un listado cuya dirección nadie puede marcar es peor que no tener listado. Publicar cuesta una transacción, y un localizador es permanente una vez en la cadena: un nombre de host o una IP escritos ahí no se pueden retirar, solo sustituir.
Los pares en la misma LAN pueden conectarse sin una entrada en el directorio, usando una multiaddr manual en el plugin de usuario.
Con la liquidación activada, el plugin escribe tu cuenta Worker incluso cuando la publicación está desactivada: la instrucción de liquidación paga a esa cuenta, así que tiene que existir. Esa fila no lleva dirección y es invisible para el descubrimiento, que es exactamente lo que quiere un worker solo de LAN.
Billetera y pagos
La sección Billetera muestra:
- la dirección del worker,
- los saldos de SOL (comisiones) y USDC (ganancias),
- sin reclamar en escrow: ingresos liquidados que ya son tuyos pero siguen dentro del escrow de la sesión,
- un botón Reclamar que mueve ese saldo a la billetera.
Cada sesión se paga por separado: una liquidación acredita la sesión y, diez minutos después de la última, cualquiera (incluido tú) puede reclamarla. El retraso es la ventana en la que el usuario todavía puede cerrar una sesión, así que no pueden pagarte por un minuto que estaban a punto de cancelar. El botón del panel procesa toda la cola.
Reclamar es una transacción, así que la billetera necesita un poco de SOL. El USDC es lo que el worker gana, no lo que gasta.
La clave privada se guarda en texto plano, con permisos 0600, en
~/.dsh/genkaku/genkaku.keys.json. Es la billetera Y la identidad de libp2p: haz
una copia de seguridad antes de mover la máquina a otro disco, y trata a cualquiera
que pueda leer ese archivo como dueño de la billetera. Rotarla cambia también tu
peer id.
Niveles de modelo
El mercado etiqueta cada modelo a partir de las capacidades que informa Ollama y del número de parámetros:
| Nivel | Significado |
|---|---|
agent | Tiene tools y al menos 9B de parámetros: apto para un bucle de agente |
light | Tiene tools pero es pequeño o de tamaño desconocido: las llamadas a herramientas pueden ser poco fiables |
chat | Sin capacidad de tools: no apto para agentes |
El nivel es una etiqueta, nunca un filtro. Nada te impide listar un modelo chat;
el usuario simplemente ve que no puede mover un agente.
Los modelos de razonamiento se ejecutan con think: false por defecto, para que
una sola petición no gaste su presupuesto en razonamiento oculto. Define
GENKAKU_OLLAMA_THINK=1 antes de arrancar DeepSeek Harness para mantener el
comportamiento predeterminado de Ollama.
Puertos y red
- libp2p escucha en
/ip4/0.0.0.0/tcp/4001y/ip6/::/tcp/4002por defecto. Abre los puertos TCP que configures si quieres conexiones directas. - El servidor de estado local se enlaza al primer puerto libre en 47821–47826. Dos perfiles de DSH en una misma máquina necesitan cada uno su propio puerto; si ves "Loading worker status…" para siempre, probablemente otro perfil ocupa ese rango.
- En Windows, permite que Node pase por el firewall la primera vez que arranca el worker.
Solución de problemas
No se detecta Ollama. Ejecuta ollama serve una vez, o pulsa Start Ollama
en el panel. Si Ollama está en otro sitio, cambia ollamaHost en la configuración
del plugin.
El interruptor Directorio aparece en gris. La máquina no tiene una dirección alcanzable globalmente. Los pares en la misma LAN aún pueden conectarse por multiaddr; si no, la sesión tendrá que ir a través del relay semilla.
Se sirvió una sesión pero el saldo no se movió. La liquidación acredita la sesión, no la billetera, y el pago espera diez minutos. Pulsa Reclamar; entonces la cifra aparece como el saldo de USDC de la billetera.
Reclamar dice que no hay nada que reclamar. O no han pasado los diez minutos desde la última liquidación, o la sesión sigue abierta (el usuario no la ha cerrado). Ambas cosas se resuelven solas; el botón del panel vuelve a leer la cadena.
¿No hay nada listado en npm? Comprueba que estás en registry.npmjs.org y no
en un espejo que aún no se ha sincronizado.