Get Started

Download the Agent

Join the network. Run the agent. Earn $NEXUS.

⬇ Download Agent

📋 Contract Addresses

All on Base Mainnet:

Token: 0x289383F655940B800E82749863DC4bE925CbddD4
Staking: 0x7bA505C8E740D1DFA0dfda900434055CF966d8E9
Faucet: 0x3B686c84D35E617b65760c029183e63e9Ad14014

System Requirements

Nexus AI agent works on most computers—even an old laptop can contribute. But more powerful hardware earns more.

💻
CPU
Any modern CPU
2+ cores recommended
🧠
RAM
4GB minimum
8GB recommended
🎮
GPU (Optional)
NVIDIA preferred
6GB+ VRAM earns more
🌐
Internet
Stable connection
Broadband recommended

Quick Start

Get up and running in 5 minutes:

1

Download

Download the agent from GitHub or clone the repository:

# Clone the repository git clone https://github.com/amanning3390/nexus-ai.git cd nexus-ai
2

Run the Installer

The installer automatically detects your hardware:

# Make executable and run chmod +x install_agent.sh ./install_agent.sh

The script detects: CPU cores, RAM, GPU (NVIDIA via nvidia-smi)

3

Connect Wallet

Enter your Base wallet address when prompted. If you don't have one, the installer can create one:

# Or use the default coordinator python agent.py --coordinator https://api.nexus-ai.io
4

Start Earning

The agent runs in the background. You'll see:

🤖 Nexus AI Agent Started 📡 Connected to coordinator 💰 Wallet: 0x1234...abcd 🖥️ Hardware: 8 CPU cores, 16GB RAM 🎮 GPU: None detected (CPU mode) ⏳ Waiting for tasks...

Advanced Options

GPU Mode

If you have an NVIDIA GPU, install CUDA and PyTorch for better rewards:

# Install CUDA toolkit, then: pip install torch --index-url https://download.pytorch.org/whl/cu118

Custom Coordinator

Run your own coordinator for private networks:

# Start coordinator locally cd coordinator pip install -r requirements.txt python main.py

Docker

Use Docker for easy setup:

# Run with Docker docker-compose up -d
⚠️ Important

The agent will use your compute resources while running. Make sure to:

  • Close other intensive applications
  • Monitor your system's cooling
  • Check your electricity costs in your area

Frequently Asked Questions

How much can I earn?
Earnings depend on your hardware. A modern GPU (RTX 3080+) can earn 1-5 NEXUS/hour. CPU-only machines earn 0.1-0.5 NEXUS/hour.
Is it safe?
Yes. The agent only runs AI tasks—it cannot access your files, passwords, or personal data. It's completely sandboxed.
Will it damage my computer?
No. The agent respects system resources and can be configured to use only a percentage of available compute. Monitor with standard tools.
Can I run it 24/7?
Yes, but it's not required. The agent only runs when you have tasks assigned. Most users run it when their computer is idle.
How do I get paid?
$NEXUS tokens stream directly to your wallet via Superfluid. No invoicing, no waiting. Check your balance at any time on BaseScan.