⚡ Become a Compute Provider with NexusWorker

Monetize your idle GPU & compute power by serving open-source AI inference on the NexusCompute decentralized network.

Whether you have a laptop (Apple Silicon MacBook M1/M2/M3/M4, Windows RTX laptop, or Linux notebook), a gaming desktop (NVIDIA RTX 3060/4080/4090), a homelab rig, or a dedicated cloud GPU cluster, NexusWorker enables you to earn passive revenue by serving inference requests for open LLMs like Llama 3, DeepSeek-R1, Mistral, and Qwen.

💡 Why Provide Compute on NexusCompute?

• 💰 Passive Income: 90% of all token fees from consumer queries are automatically credited to your provider wallet in real time.
• 🔒 100% Secure & Outbound-Only: Zero inbound open ports, no port-forwarding, and no router configuration needed. The daemon connects outbound to Cloudflare Edge.
• 🛡️ Completely Sandboxed: Only interacts with your local inference backend (Ollama / vLLM) over localhost (127.0.0.1).
• ⚡ 1-Minute Setup: Install in a single command with pip install nexus-worker.
• 🖥️ Full Cross-Platform Support: macOS (Apple Silicon unified memory & Intel), Windows 10/11, and Linux.
• ⏸️ You're in Control: Start, pause, or stop whenever you need your machine for gaming or work (Ctrl + C).

🚀 Provider Quickstart Guide (Under 3 Minutes)

Requirements:

• OS: macOS (Apple Silicon M-series or Intel), Windows 10/11, or Linux
• Python: 3.9 or higher
• Inference Engine: Ollama (recommended for 1-click local setup) or vLLM
• Hardware: Any modern GPU (NVIDIA RTX 2060/3060/4090, Apple Silicon unified memory), or CPU with emulation support

Step 1: Install Ollama & Pull a Model

Ollama runs natively on Mac, Windows, and Linux:

1. Download & install from ollama.com/download.
2. Open your terminal and pull an open-source model:

   ollama run llama3:8b
   

   (You can also serve deepseek-r1:7b or mistral:7b).

Step 2: Install NexusWorker from PyPI

Install the official provider daemon using pip:

pip install nexus-worker

Verify your hardware and local model detection:

nexus-worker info

Example output:

============================================================
              NEXUSCOMPUTE HARDWARE DETECTOR                
============================================================
• GPU: Apple M3 Max / NVIDIA GeForce RTX 4090
• VRAM: 36,864 MB
• Backend Engine: Ollama (http://127.0.0.1:11434)
• Discovered Models:
    - llama3:8b
    - deepseek-r1:7b
============================================================

Step 3: Register Your Node on the Dashboard

1. Go to nexus-compute.pages.dev.
2. Sign in and open the Provider Node tab.
3. Type a name for your machine (e.g., MacBook-Pro-M3 or Alienware-RTX4080) and click Add Node.
4. Copy your unique node token (nx-node-...).

Step 4: Connect & Start Earning

Start the worker daemon:

nexus-worker start --token nx-node-YOUR_TOKEN_HERE

That's it! Your machine is now connected to the decentralized inference mesh:

• The node will automatically appear online in your dashboard.
• When consumers run queries on your served model, your node streams tokens and 90% of token fees are automatically credited to your wallet in real time.

💡 Testing Without Downloading Large Models (Emulation Mode)

If you want to test connecting your node immediately before downloading gigabytes of model weights, run with the --emulate flag:

nexus-worker start --token nx-node-YOUR_TOKEN_HERE --emulate

The daemon will simulate high-performance streaming token output (~45 tok/s), allowing you to verify coordinator connectivity, heartbeat telemetry, and testnet payouts right away.

🛠️ CLI Reference for Providers

nexus-worker [OPTIONS] COMMAND [ARGS]...

Commands:
  info   Display local GPU hardware specifications and discovered AI engines.
  start  Start the provider daemon and connect outbound to the NexusCompute network.

Options for nexus-worker start:

Example with custom coordinator or endpoint:

nexus-worker start --token nx-node-0a0a3b29ed4e323af354549a6681821a1b75157e

❓ Frequently Asked Questions (FAQ) for Providers

💻 Developer Installation (From Source)

If you wish to contribute to the open-source provider daemon codebase:

git clone https://github.com/nexus-compute-ai/nexus-worker.git
cd nexus-worker

# Setup virtual environment
python -m venv .venv
source .venv/bin/activate  # Or .\.venv\Scripts\activate on Windows

# Install in editable mode
pip install -e .

📄 License

Distributed under the MIT License. See LICENSE for more details.