Pular para o conteúdo principal

Instalar no Windows

O Docker Desktop roda o agente do mesmo jeito que o Linux. Você nunca mexe no WSL diretamente — o Docker Desktop instala e gerencia seu próprio backend WSL2, e o agente roda dentro dele.

1. Instale as peças​

  1. Driver NVIDIA — o driver normal do Windows, em nvidia.com/drivers, versão 575 ou mais nova. Não existe um driver separado para o WSL; o do Windows já cobre isso.
  2. Docker Desktop com o backend WSL2 (o padrão). Deixe ele terminar a configuração inicial.

Depois confira os dois no PowerShell:

docker run hello-world
docker run --rm --gpus all nvidia/cuda:12.4.1-base-ubuntu22.04 nvidia-smi

O segundo precisa imprimir sua placa. Se não imprimir, o driver está desatualizado ou o Docker Desktop não está no backend WSL2.

2. Escolha uma senha e guarde-a​

O Windows não tem openssl, então pegamos emprestado de um contêiner — isso funciona em qualquer máquina que consiga rodar Docker.

$pw = docker run --rm alpine sh -c "head -c 32 /dev/urandom | base64 -w0"
echo $pw   # anote isso agora

3. Rode​

Note o acento grave ` para continuar linhas — o equivalente do PowerShell ao \.

docker run -d --name neurogrid-agent `
  --gpus all --restart unless-stopped `
  --log-driver json-file `
  --log-opt max-size=10m `
  --log-opt max-file=3 `
  --dns 1.1.1.1 --dns 8.8.8.8 `
  -v neurogrid-data:/data `
  -v /var/run/docker.sock:/var/run/docker.sock `
  -v /var/lib/neurogrid/workloads:/var/lib/neurogrid/workloads `
  -e AGENT_ENCRYPTION_PASSWORD="$pw" `
  ghcr.io/neurogrid-ai-exchange/neurogrid-agent:latest --token ng_live_xxxxxxxx

Depois acompanhe o registro:

docker logs -f neurogrid-agent

Procure por Bootstrap sent successfully, depois Heartbeat sent successfully a cada 30 segundos.

Esses caminhos com cara de Unix estão corretos

/var/run/docker.sock e /var/lib/neurogrid/workloads não são caminhos do Windows e você não precisa criá-los. Eles são resolvidos dentro da VM Linux do Docker Desktop, onde vivem tanto o contêiner do agente quanto o daemon do Docker.

Mantenha a máquina acordada​

Um notebook com Windows que suspende para de servir, e um trabalho em andamento falha. Antes de deixar um host rodando:

  • Configurações → Sistema → Energia e bateria → Tela e suspensão — defina a suspensão para Nunca enquanto estiver na tomada.
  • Desative a Inicialização rápida se a máquina reiniciar sem supervisão (Painel de controle → Opções de energia → Escolher o que os botões de energia fazem).

O Docker Desktop precisa estar rodando​

O agente é um contêiner, então só roda enquanto o Docker Desktop também roda. Ative Iniciar o Docker Desktop ao fazer login (Configurações → Geral), e lembre que isso significa que a máquina precisa fazer login depois de um reinício — um host sem supervisão fica melhor no Linux.

Próximo passo​