NEXUSNEXUS

Supply side · run a worker

Lend your GPU. Earn $NEXUS.

NEXUS is powered by community machines. Connect your GPU to the network, serve inference jobs for people and apps, and earn $NEXUS for every completed job — paid to your own wallet.

GPUs online

—

Serving now

—

Jobs served

—

Total earned

—

$NEXUS

Live servers

Loading network…

How earning works

01

Connect your GPU

Run the worker daemon. It registers your GPU + payout wallet with the coordinator over WebSocket.

02

Serve prompts

The coordinator routes paid jobs to idle workers and streams your tokens back to the user in real time.

03

Earn $NEXUS

Each completed job credits your wallet a share of the prompt fee. Claim your balance anytime.

Your earnings

Sign in with the wallet you run your worker under to track and claim earnings.

Run a worker

Lend your PC to the network and earn $NEXUS per job. Needs Node.js, Git, and your Phantom wallet address.

Quick start

  1. Install Node.js LTS + Git
  2. Open a terminal and run the commands below
  3. Paste your Phantom address into WORKER_WALLET — to show yours
  4. GPUs online above should hit 1
  5. Sign in on this page with the same wallet to track & claim earnings

1 · Paste into worker/.env

# worker/.env
COORDINATOR_WS=wss://nexus-production-ad34.up.railway.app/worker
WORKER_WALLET=<your Phantom wallet address>
WORKER_GPU=RTX 4090 24GB

# Optional — real inference (install Ollama first):
# OLLAMA_URL=http://localhost:11434
# OLLAMA_MODEL=llama3.2

2 · Run in terminal

git clone https://github.com/aliasbacardi/nexus.git
cd nexus/worker
cp .env.example .env
# Edit .env — paste the block below, then:
npm install && npm start

First run is mock mode (fake AI) — good for testing. Add Ollama later for real inference. See the full guide below.

First time? Full step-by-step guide (click to expand)

You will need

  • A Windows, Mac, or Linux computer
  • Phantom wallet — where earnings go
  • ~15 minutes if you have never used a terminal before
1

Install Node.js

Download the LTS installer from nodejs.org. Click through with defaults. Verify with node -v in a terminal.

2

Install Git

Download from git-scm.com. On Windows, pick "Git from the command line" when asked.

3

Open a terminal

  • Windows: Win + R → type cmd → Enter
  • Mac: Cmd + Space → Terminal
  • Optional: cd Desktop to work on your Desktop
4

Download the code

Copy & paste

git clone https://github.com/aliasbacardi/nexus.git
cd nexus/worker
cp .env.example .env
5

Edit worker/.env

  • Windows: cd nexus\worker → copy .env.example .env → notepad .env
  • Mac/Linux: cd nexus/worker → cp .env.example .env → open in any editor
  • Paste the env block from Quick start above. Save and close.
6

Start the worker

npm install
npm start

# Stop with Ctrl+C when done

Success looks like:

[worker] ✅ registered as xxxxxxxx
[worker] waiting for jobs…

Leave the terminal open. Ctrl+C stops the worker.

7

Verify & earn

  • GPUs online → 1, and you appear under Live servers
  • Sign in above with the same wallet as WORKER_WALLET
  • Claim $NEXUS when payout is enabled
8

Optional — real AI (Ollama)

  • Install Ollama, run ollama pull llama3.2
  • Uncomment OLLAMA lines in .env, restart worker
Something wrong? Common fixes

GPUs online stays 0 — check COORDINATOR_WS in .env. Terminal must show "waiting for jobs".

Earnings show 0 — WORKER_WALLET does not match the wallet you signed in with. Fix .env, restart worker.

'node' is not recognized — install Node.js and open a fresh terminal.

Claim does nothing — on-chain payout may not be live yet. Balance is still tracked as Claimable.

Optional — Docker instead of Node.js

Mock mode

docker run -d --name nexusprompt-worker --restart unless-stopped \
  -e COORDINATOR_WS=wss://nexus-production-ad34.up.railway.app/worker \
  -e WORKER_WALLET=<your Phantom wallet address> \
  -e WORKER_GPU="RTX 4090 24GB" \
  yourusername/nexusprompt-worker:latest

With Ollama

docker run -d --name nexusprompt-worker --restart unless-stopped \
  --add-host=host.docker.internal:host-gateway \
  -e COORDINATOR_WS=wss://nexus-production-ad34.up.railway.app/worker \
  -e WORKER_WALLET=<your Phantom wallet address> \
  -e WORKER_GPU="RTX 4090 24GB" \
  -e OLLAMA_URL=http://host.docker.internal:11434 \
  -e OLLAMA_MODEL=llama3.2 \
  yourusername/nexusprompt-worker:latest

Logs & stop

# Watch logs
docker logs -f nexusprompt-worker

# Stop when done
docker stop nexusprompt-worker && docker rm nexusprompt-worker

Repo: https://github.com/aliasbacardi/nexus · Coordinator: wss://nexus-production-ad34.up.railway.app/worker