installation

install the neuranet node agent on your system

prerequisites

• docker version 20.10 or higher
• stable internet connection
• solana wallet address for receiving payments
• (optional) nvidia gpu with updated drivers

option 1: npm install (recommended)

install via npm for the easiest setup experience.

step 1: install node.js

download from nodejs.org (lts version recommended)

step 2: install neuranet agent

npm install -g @neuranet/node-agent

step 3: verify installation

neuranet --version

option 2: standalone binary

no node.js required. download and run directly.

windows (powershell)

# download the installer
Invoke-WebRequest https://neuranet.network/download/neuranet-installer.exe -OutFile neuranet-installer.exe

# run the installer
.\neuranet-installer.exe

# verify installation
neuranet --version

linux / macos

# download and install
curl -L https://neuranet.network/download/install.sh | bash

# verify installation
neuranet --version

option 3: docker

for servers and advanced users. runs in an isolated container.

pull the image

docker pull neuranet/node-agent:latest

run with gpu support (nvidia)

docker run -d \
  --name neuranet-node \
  --restart unless-stopped \
  --gpus all \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v neuranet-data:/data \
  -e WALLET_ADDRESS=YOUR_WALLET_ADDRESS \
  neuranet/node-agent:latest

run cpu-only

docker run -d \
  --name neuranet-node \
  --restart unless-stopped \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v neuranet-data:/data \
  -e WALLET_ADDRESS=YOUR_WALLET_ADDRESS \
  neuranet/node-agent:latest

verify docker is working

the node agent requires docker to run workloads. verify it's installed:

# check docker is running
docker info

# check gpu access (nvidia)
docker run --rm --gpus all nvidia/cuda:12.0-base nvidia-smi