Skip to main content

⚡ Become a Compute Provider with NexusWorker

PyPI License: MIT Python 3.9+ Provider Portal

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

Whether you have a single gaming PC (NVIDIA RTX 3060/4090), an Apple Silicon Mac (M1/M2/M3/M4), or a dedicated mining rig / GPU cluster, NexusWorker enables you to earn revenue passively by serving inference requests for open models like Llama 3, DeepSeek-R1, and Mistral.


💡 Why Provide Compute on NexusCompute?

  • 💰 Passive Income: Earn revenue for every prompt token and completion token your GPU processes.
  • 🔒 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 communicates with your local inference backend (Ollama / vLLM) over 127.0.0.1.
  • ⚡ 1-Minute Setup: Install in a single command with pip install nexus-worker.
  • 🖥️ Full Cross-Platform Support: Runs seamlessly on Windows, Linux, and macOS.
  • ⏸️ You're in Control: Start, pause, or stop whenever you need your GPU for gaming or work (Ctrl + C).

🚀 Provider Quickstart Guide (Under 3 Minutes)

Step 1: Get Your Node Token

  1. Open the NexusCompute Provider Portal.
  2. Go to the Provider Dashboard and click Become a Provider or Register Node.
  3. Copy your unique Node Token (e.g., nx-node-0a0a3b29ed...).

Step 2: Ensure Your Local Engine is Running

We recommend Ollama for the easiest 1-click setup:

  1. Install Ollama and pull any model you want to serve:
    ollama pull llama3:8b
    ollama pull deepseek-r1:7b
    
  2. Verify Ollama is running at http://localhost:11434.

(Note: vLLM is also supported for high-throughput enterprise setups).

Step 3: Install & Start Serving

Open your terminal (PowerShell, Command Prompt, or Terminal on macOS/Linux) and run:

# 1. Install the official provider daemon from PyPI
pip install nexus-worker

# 2. (Optional) Check your detected GPU & available local models
nexus-worker info

# 3. Start earning!
nexus-worker start --token nx-node-YOUR_TOKEN_HERE

That's it! Your node will register with the network, begin long-polling for inference tasks, stream responses back to users, and track your earnings on your live dashboard.


🛠️ CLI Reference for Providers

nexus-worker start

Connects your machine to the NexusCompute coordinator network and begins processing jobs.

Flag Default Description
--token (required) - Your unique node token from the provider dashboard
--coordinator https://nexus-compute.pages.dev NexusCompute Coordinator edge endpoint
--ollama-url http://localhost:11434 Endpoint for local Ollama instance
--vllm-url http://localhost:8000 Endpoint for local vLLM instance
--engine auto Backend engine selection (auto, ollama, vllm, emulate)
--poll-interval 1.0 Polling heartbeat interval (seconds)
--emulate false Run in emulation / mock mode to test connection without GPU

Example:

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

nexus-worker info

Scans and displays your local system specs (GPU model, VRAM, and discovered models ready to serve):

nexus-worker info

❓ Frequently Asked Questions (FAQ) for Providers

Do I need to open any firewall ports or configure port-forwarding on my router?
No. NexusWorker uses outbound HTTP/2 long-polling to communicate with the coordinator edge. Because all network traffic is initiated outbound from your computer, it works behind any home router, NAT, corporate firewall, or VPN without any configuration.
What happens when I want to play games or use my GPU?
Simply press Ctrl + C in the terminal where nexus-worker is running. The daemon will gracefully disconnect and notify the coordinator. Whenever you are done with your GPU, run nexus-worker start --token ... to resume earning.
What hardware is required?
Any GPU with at least 6 GB VRAM (e.g. NVIDIA RTX 2060/3060/4060/4090, AMD Radeon 6000/7000 series, or Apple Silicon M1/M2/M3/M4 with unified memory). You can also run CPU inference or test using the --emulate flag.
How do I track my earnings and node uptime?
Visit your Provider Dashboard to view real-time metrics including tokens served, active hours, latency benchmarks, and accrued balance.

💻 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.

Metadata

Release files for nexus-worker 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for nexus-worker 0.1.1
File Size Uploaded Provenance Actions
nexus_worker-0.1.1.tar.gz 13.9 kB With provenance Details for nexus_worker-0.1.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for nexus-worker 0.1.1
File Interpreter ABI Platform Actions
nexus_worker-0.1.1-py3-none-any.whl Python 3 none any Details for nexus_worker-0.1.1-py3-none-any.whl

Total release size: 26.6 kB

Release files / nexus_worker-0.1.1.tar.gz

Download URL nexus_worker-0.1.1.tar.gz
Size 13.9 kB
Tags Source
SHA-256 checksum
How to use checksums
9839ead4628719a921d344a7a8324cca7cb15a1486dbce383a59a80299fbeff1
BLAKE2b-256 checksum
How to use checksums
7eb393815ddf78adcde280cc09bb131b289a6e510db0f2471ee8bf5e28ea28fb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 1, 2026.

Transparency log

Release files / nexus_worker-0.1.1-py3-none-any.whl

Download URL nexus_worker-0.1.1-py3-none-any.whl
Size 12.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
96808d2087475ae95339a8ae8f1bb9cbbbf60d06119c7cce8cb0186e3800c3e8
BLAKE2b-256 checksum
How to use checksums
ed55c97eefd4fd4d2d3520b223002be876decaf87eb6f999601f120052611b7d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 1, 2026.

Transparency log

Security for nexus-worker 0.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for nexus_worker-0.1.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 1, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page