Consigue el agente

El agente es un solo contenedor. Registra tu GPU, espera trabajo, corre el modelo y reporta de vuelta. Lo instalas una vez y lo dejas corriendo.

No hay nada que descargar — sin instalador, sin binario que colocar, sin Python que configurar. Todo va dentro de una imagen de Docker, así que lo único que necesita tu máquina es Docker y un driver de NVIDIA.

docker pull ghcr.io/neurogrid-ai-exchange/neurogrid-agent:latest

Instalar en Linux →Docker nativo. El camino más corto, y lo que corre la mayoría de hosts.Instalar en Windows →Docker Desktop. Nunca tocas WSL directamente.

Antes de empezar

Necesitas dos cosas, y ambas las obtienes de la consola.

Un token de máquina. Agrega tu GPU en la consola y te entrega un token con forma ng_live_…. Se muestra una sola vez. El agente lo usa para reclamar la tarjeta, y nunca lo vuelve a necesitar después de esa primera ejecución.

Una contraseña que tú eliges. Cifra el token donde se guarda en tu máquina. La eliges tú, la guardas tú, y necesitas la misma cada vez que se recrea el contenedor — una actualización incluida. Nosotros nunca la vemos, y no podemos restablecerla.

Perder la contraseña significa volver a registrarte

El token guardado está cifrado con una clave derivada de tu contraseña. Una contraseña distinta no puede leerlo, así que la máquina tiene que registrarse de nuevo con un token nuevo.

Qué pasa en esa primera ejecución

1. El agente arranca y no encuentra ningún token guardado, así que usa el que le pasaste.
2. Lee tu GPU, CPU, RAM, disco y ubicación aproximada, y los registra.
3. El backend verifica que la tarjeta coincide con lo que indicaste en la consola.
4. La consola marca tu GPU como confirmada, y el agente queda inactivo, esperando trabajo.

A partir de ahí envía un heartbeat cada 30 segundos. Cuando llega un trabajo, descarga el modelo, lo sirve, y abre un túnel para que el cliente pueda alcanzarlo.

Requisitos de un vistazo

	Mínimo	Recomendado
SO	Linux de 64 bits (kernel 5.x+), o Windows 11 + WSL2	Ubuntu 22.04 / 24.04 LTS
GPU	NVIDIA, 6 GB VRAM	16–24 GB+ VRAM
Driver NVIDIA	575+ (CUDA 12.9)	Última versión estable
CPU	4 núcleos	8+ núcleos
RAM	8 GB	32 GB+
Disco libre	50 GB SSD	100 GB+ NVMe SSD
Red	25 Mbps de bajada, estable	100 Mbps+ simétricos

Requisitos completos, incluyendo qué tarjetas son compatibles →

Y después

• Mantenerlo actualizado — cómo pasar a una versión nueva
• Administrarlo — iniciar, detener, logs, comprobar que sigue vivo
• Pagos — cuándo llega realmente el dinero