Usar modelos de la red

El plugin de usuario añade la red GenKaKu como proveedor de modelos dentro de DeepSeek Harness. Desde una sesión de agente eliges el modelo de un par igual que eliges uno local. No hay cuenta, ni correo, ni clave de API.

Requisitos

• DeepSeek Harness 0.2.2-rc.1 o posterior, y Node 22+.
• Una billetera en Base Sepolia con ETH de prueba para el gas. El plugin genera una.
• USDC de prueba para los modelos de pago. El panel puede acuñar 100 USDC de prueba en esta red; no tienen ningún valor.

Instalación

En DeepSeek Harness abre Plugins → Añadir plugin y pega:

@genkaku/dsh-user-plugin

Deja la fuente de instalación en Registro predeterminado (registry.npmjs.org), confirma y reinicia DeepSeek Harness. Desde una shell:

dsh plugin add @genkaku/dsh-user-plugin

Los plugins de worker y de usuario pueden convivir en la misma máquina. Cada uno mantiene su propia billetera y su propia configuración.

Billetera

La sección de billetera del panel genera una billetera en el primer uso, o importa una clave privada de 32 bytes en formato 0x…. Muestra:

• la dirección,
• ETH (gas),
• USDC (saldo disponible para gastar).

La clave privada se guarda en texto plano, con permisos 0600, en ~/.dsh/genkaku/genkaku.keys.json. Nosotros nunca la tenemos y no podemos recuperarla.

Recarga la dirección con ETH de Base Sepolia desde un faucet y acuña USDC de prueba desde el panel.

Encontrar un worker

El panel lista lo que ofrece la red:

• Modelos en la red: cada fila muestra el modelo, el worker, la tarifa por hora, el nivel y la latencia medida.
• Workers descubiertos: pares encontrados a través del directorio en la cadena y del relay semilla. La cifra es lo que el descubrimiento ve en este momento, no un total global.

La etiqueta de nivel (agent / light / chat) procede de las capacidades de Ollama del worker. Solo los modelos agent están pensados para mover un bucle de agente con llamadas a herramientas; los modelos chat se marcan como no aptos para agentes, pero nada te impide usar uno para un chat normal.

Si conoces la multiaddr de un worker, añádela en Workers manuales; funciona en la misma LAN y no necesita entrada en el registro.

Ejecutar una sesión

En una sesión de DeepSeek Harness, abre el selector de modelos y elige un modelo GenKaKu. El plugin:

1. marca el worker directamente, o a través del relay semilla si una conexión directa es imposible,
2. para un modelo de pago, abre un escrow en USDC en JobEscrow antes del primer token,
3. transmite los tokens a medida que Ollama los genera,
4. liquida cuando termina la sesión.

Los modelos gratuitos (tarifa 0) se saltan los pasos 2 y 4 por completo: sin escrow, sin gas, sin transacción.

Cuánto cuesta una sesión

Concepto	Quién paga
Inferencia	Tú, en USDC, por minuto iniciado
Gas para abrir el escrow	Tú
Gas para liquidar	Tú
Comisión de plataforma	1% de la liquidación del worker, a la tesorería

Por tanto, una sesión de pago cuesta dos transacciones en la cadena: abrir el escrow y luego liquidar. Si la sesión termina sin nada facturado, el escrow se reembolsa.

La facturación es por minuto iniciado: parar a los diez segundos sigue facturando un minuto, a la tarifa por hora del worker dividida entre 60.

Configuración

• Pagos: con la liquidación activada, cada sesión de pago abre un escrow. Desactívala para sesiones gratuitas o de desarrollo que no firman nada en la cadena; vuelve a activarla antes de usar la red contra workers reales.
• Workers manuales: fija a mano la multiaddr de un worker.
• Actualizar: vuelve a escanear el directorio de la cadena y la semilla. El puente se reinicia cuando termina el escaneo, y un perfil que haya cambiado su billetera también necesita reiniciarse antes de poder operar.

El puente local se enlaza al primer puerto libre en 47821–47826 y solo responde si es la mitad de usuario; un servidor de estado de worker en la misma máquina no se confundirá con él.

Preguntas frecuentes

¿Tengo que confiar en GenKaKu Labs?
Tienes que confiar en los contratos y en el código. Ningún servidor guarda tus fondos ni tus prompts.

¿Puedo usarlo sin billetera?
Solo para modelos gratuitos con la liquidación desactivada. Las sesiones de pago y la identidad son la billetera.

¿Esto es mainnet?
No. Los plugins rechazan un chain ID de mainnet. No envíes fondos reales.

¿Quién puede ver mis prompts?
El worker que los sirve, siempre. Si la sesión pasa por el relay semilla, el operador del relay ve metadatos de conexión —direcciones, tiempos y volumen—, pero no el contenido cifrado.

¿Por qué desapareció mi modelo del selector?
El adaptador sondea los puertos del puente local y solo acepta un puente que informe del rol user. Un puerto obsoleto en manos de otro perfil se ignora y vuelve a aparecer en la siguiente actualización.