Consiga o agente
O agente é um único contêiner. Ele registra sua GPU, espera trabalho, roda o modelo e reporta de volta. Você instala uma vez e deixa rodando.
Não há nada para baixar — sem instalador, sem binário para colocar em algum lugar, sem Python para configurar. Tudo vem dentro de uma imagem Docker, então as únicas coisas que sua máquina precisa são Docker e um driver NVIDIA.
docker pull ghcr.io/neurogrid-ai-exchange/neurogrid-agent:latest
Antes de começar
Você precisa de duas coisas, e as duas vêm da consola.
Um token de máquina. Adicione sua GPU na consola e ela te entrega um
token no formato ng_live_…. Ele aparece uma única vez. O agente usa
isso para reivindicar a placa, e nunca mais precisa dele depois dessa
primeira execução.
Uma senha que você escolhe. Ela criptografa o token onde ele fica guardado na sua máquina. Você escolhe, você guarda, e precisa da mesma senha toda vez que o contêiner for recriado — uma atualização incluída. Nós nunca a vemos, e não podemos redefini-la.
O token guardado é criptografado com uma chave derivada da sua senha. Uma senha diferente não consegue lê-lo, então a máquina precisa ser registrada de novo com um token novo.
O que acontece nessa primeira execução
- O agente inicia e não encontra nenhum token guardado, então usa o que você passou.
- Ele lê sua GPU, CPU, RAM, disco e localização aproximada, e registra tudo.
- O backend verifica se a placa corresponde ao que você informou na consola.
- A consola marca sua GPU como confirmada, e o agente fica ocioso, esperando trabalho.
A partir daí ele envia um heartbeat a cada 30 segundos. Quando um trabalho chega, ele baixa o modelo, serve, e abre um túnel para que o cliente consiga alcançá-lo.
Requisitos de relance
| Mínimo | Recomendado | |
|---|---|---|
| SO | Linux 64 bits (kernel 5.x+), ou 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 versão estável |
| CPU | 4 núcleos | 8+ núcleos |
| RAM | 8 GB | 32 GB+ |
| Disco livre | 50 GB SSD | 100 GB+ NVMe SSD |
| Rede | 25 Mbps de download, estável | 100 Mbps+ simétricos |
Requisitos completos, incluindo quais placas são compatíveis →
E depois
- Mantendo atualizado — como passar para uma versão nova
- Gerenciando — iniciar, parar, logs, verificar se está vivo
- Pagamentos — quando o dinheiro realmente chega