Provider Guide

Transform your computer into an AI compute provider and start earning rewards! This guide will walk you through becoming part of the Cxmpute network.

What is a Cxmpute Provider?

Cxmpute provides inference and related services powered by a global network of nodes run by providers. Learn more about using Cxmpute services →

A provider is someone who runs a Cxmpute node on their computer. This node is essentially an inference server connected to our main orchestrator, so requests are routed to your node for inference and completion, and you are rewarded proportionally.

Hardware Tiers

We categorize devices into different tiers based on their capabilities. We need devices of all tiers, but we highly recommend becoming a provider if you have at least 16GB RAM and 30GB free disc space.

Device Tiers

During testnet, all providers earn points and rewards. Mainnet earnings structure is to be determined (TBD).

System Requirements

Minimum Requirements

• OS: macOS 10.15+, Linux (Ubuntu 18.04+), Windows 10+
• RAM: 4GB+ (16GB+ recommended for LLM services)
• Storage: 10GB+ free space
• Internet: Stable broadband connection

Optimal Requirements

• GPU: NVIDIA GPU with 8GB+ VRAM (for LLM hosting)
• RAM: 16GB+ (32GB+ for large models)
• CPU: Multi-core processor (Intel i5/AMD Ryzen 5+/Apple Silicon)
• Internet: High-speed connection (100+ Mbps) If your system is supported by llama.cpp, your device is eligible to be a provider.

Getting Started

Step 1: Create an Account

Create an account in the Cxmpute Dashboard.

Step 2: Prerequisites

Before installing the Cxmpute Provider CLI, ensure you have the following:

🍎 macOS Users:

• Homebrew (for package management)
• Node.js 18.x (will be installed automatically if missing)

🐧 Linux Users:

• Node.js 18.x (will be installed automatically if missing)
• One of these package managers:
  • apt (Debian/Ubuntu)
  • yum (RHEL/CentOS)
  • dnf (Fedora)

🪟 Windows Users:

• PowerShell 5.1 or later
• Node.js 18.x (will be installed automatically if missing)
• Administrator privileges

Step 3: Install the Provider CLI

Choose your platform and follow the installation instructions:

🍎 macOS

# Option 1: Direct install
curl -fsSL https://raw.githubusercontent.com/unxversal/cxmpute-core/main/clis/cxmpute-provider/installers/macos/install.sh | sudo bash

# Option 2: Homebrew (coming soon)
brew install cxmpute-provider

🐧 Linux

# Direct install
curl -fsSL https://raw.githubusercontent.com/unxversal/cxmpute-core/main/clis/cxmpute-provider/installers/linux/install.sh | sudo bash

🪟 Windows

# Run in PowerShell as Administrator
Set-ExecutionPolicy Bypass -Scope Process -Force
[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072
iex ((New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/unxversal/cxmpute-core/main/clis/cxmpute-provider/installers/windows/install.ps1'))

Step 4: Start the Provider

After installation, you can run the CLI from anywhere:

cxmpute-provider

The CLI includes:

• 🔒 Embedded Authentication: No environment variables needed
• 🖥️ Cross-Platform Support: Linux, macOS (Intel & Apple Silicon), Windows
• ⚡ Zero-Config Setup: Automatic hardware detection and service configuration
• 💰 Real-Time Earnings: Live dashboard with earnings tracking
• 🔧 Provider Tools: Complete CLI for compute providers

Step 5: Follow the Setup Wizard

When you run cxmpute-provider for the first time, you'll see:

 ██████╗██╗  ██╗███╗   ███╗██████╗ ██╗   ██╗████████╗███████╗
██╔════╝╚██╗██╔╝████╗ ████║██╔══██╗██║   ██║╚══██╔══╝██╔════╝
██║      ╚███╔╝ ██╔████╔██║██████╔╝██║   ██║   ██║   █████╗  
██║      ██╔██╗ ██║╚██╔╝██║██╔═══╝ ██║   ██║   ██║   ██╔══╝  
╚██████╗██╔╝ ██╗██║ ╚═╝ ██║██║     ╚██████╔╝   ██║   ███████╗
 ╚═════╝╚═╝  ╚═╝╚═╝     ╚═╝╚═╝      ╚═════╝    ╚═╝   ╚══════╝

🔧 SETUP WIZARD

The CLI will guide you through:

1. Hardware Detection: Automatic system profiling
2. Provider Registration: Creating your provider account
3. Service Configuration: Selecting services based on your hardware
4. Network Setup: Configuring tunnels and connectivity

Step 6: Start Earning!

After setup, you'll see your provider dashboard:

╭────────────────────────────────────────────────────────╮
│ PROVIDER/REFERRAL ID: abc123...                        │
╰────────────────────────────────────────────────────────╯

╭────────────────────────────────────────────────────────╮
│ ● STATUS: ACTIVE                                       │
╰────────────────────────────────────────────────────────╯

╭──────────────────────────╮ ╭───────────────────────────╮
│ TODAY'S POINTS: 1,245    │ │ ALL TIME POINTS: 34,210   │
╰──────────────────────────╯ ╰───────────────────────────╯

╭────────────────────────────────────────────────────────╮
│ REFERRALS: 3                    LEARN MORE             │
╰────────────────────────────────────────────────────────╯

╭────────────────────────────────────────────────────────╮
│ DEVICE TIER: Deep Ocean (Tier 4 - 22GB+ VRAM)         │
╰────────────────────────────────────────────────────────╯

🎉 Congratulations! Your node is running and earning rewards.

Join our Discord community to stay updated on earnings announcements, connect with other providers, and get support!

Maximizing Your Earnings

💰 Earning Rewards

Service Types & Rewards

During testnet, providers earn points and rewards for all services. Mainnet earnings structure is to be announced (TBA).

• 🤖 LLM Inference: Points for token generation (varies by model)
• 🔍 Embeddings: Points for embedding requests
• 🌐 Web Scraping: Points per scraping request
• 🗣️ Text-to-Speech: Points for audio generation

Best Practices

1. ⏰ Uptime: Keep your provider running as much as you can for maximum earnings
2. 🚀 Performance: Ensure stable internet and optimal hardware
3. 👥 Referrals: Invite others and earn from their activity (learn more)
4. 🔄 Updates: Keep your CLI updated for new features
5. 🔧 Optimization: Run when you're not using your computer to maximize resources

When to Run Your Node

💡 Recommended: Run your node when you're not using your computer, as it tries to use most of your computing power to maximize earnings.

• 🌙 Overnight: Perfect time for maximum resource allocation
• 📅 Weekends: Extended periods of high earning potential
• 🎯 Scheduled: Set up automated schedules for consistent operation

How Providers Earn

Points System

Providers earn points based on:

• Usage: Requests processed and tokens generated
• Quality: Response time and reliability
• Referrals: People you invite who become active users or providers

Revenue Distribution

At the end of each epoch (usually a month), revenue is distributed proportionally based on points accumulated:

1. Platform collects revenue from users
2. Points are tallied for all providers
3. Revenue is distributed based on each provider's share of total points
4. Payments are processed automatically

Earning More Points

• 📈 High Uptime: Consistent availability increases point multiplier
• ⚡ Fast Response: Better performance = more requests routed to you
• 🎯 Referrals: Earn bonus points from referred users' activity
• 🔧 Better Hardware: Higher tiers get priority for premium requests

Service Types

Your node will automatically provide services based on your hardware capabilities:

🤖 LLM Inference (/chat/completions)

• Requirements: 16GB+ VRAM recommended
• Models: Various sizes from 7B to 70B+ parameters
• Earnings: Highest earning potential

🔍 Embeddings (/embeddings)

• Requirements: 2GB+ VRAM
• Models: Specialized embedding models
• Earnings: Consistent, moderate volume

🗣️ Text-to-Speech (/tts)

• Requirements: 1GB+ VRAM or good CPU
• Models: Voice synthesis models
• Earnings: Steady demand

🌐 Web Scraping (/scrape)

• Requirements: Good internet connection
• Function: Content extraction and processing
• Earnings: Per-request based

Troubleshooting

Common Issues

"Command not found: cxmpute-provider"

• Cause: Binary not in PATH or not executable
• Fix: Follow the installation steps above, ensure file is executable

"Permission denied"

• macOS/Linux: Run chmod +x cxmpute-provider-*
• Windows: Run as Administrator

"Node start failed: ECONNREFUSED"

• Cause: Network connectivity issue
• Fix: Check internet connection, restart the CLI

macOS Security Warning

1. Go to System Preferences > Security & Privacy > General
2. Click "Allow Anyway" for cxmpute-provider
3. Re-run the application

Windows SmartScreen Warning

1. Click "More info"
2. Click "Run anyway"
3. The application will start normally

Low Earnings

• Check your device tier - upgrade hardware for better rates
• Ensure stable internet connection (100+ Mbps recommended)
• Maximize uptime - run 24/7 for consistent earnings
• Check for software conflicts (antivirus, firewall)

Status Indicators

• Green ●: Provider active and earning
• Yellow ●: Provider starting up
• Red ●: Provider error or offline

Security & Privacy

What Data is Collected

• Hardware specs: For service assignment
• Usage metrics: For earnings calculation
• Error logs: For debugging and support

What's NOT Collected

• Personal files: No access to your documents
• Browsing history: No tracking of web activity
• Sensitive data: No personal information stored

Data Protection

• All communications are encrypted
• Provider credentials are embedded securely
• No sensitive data is transmitted

Install Globally (Optional)

Make cxmpute-provider available from anywhere on your system:

🍎 macOS

# Install globally
sudo mv ~/Downloads/cxmpute-provider-macos /usr/local/bin/cxmpute-provider

# Now run from anywhere
cxmpute-provider

🐧 Linux

# Install globally
sudo mv ~/Downloads/cxmpute-provider-linux /usr/local/bin/cxmpute-provider

# Now run from anywhere
cxmpute-provider

🪟 Windows

Option 1: System32 (requires admin)

# Open Command Prompt as Administrator
move "%USERPROFILE%\Downloads\cxmpute-provider.exe" "C:\Windows\System32\cxmpute-provider.exe"

# Now run from anywhere
cxmpute-provider

Option 2: Add to PATH

1. Create folder: C:\cxmpute\
2. Move cxmpute-provider.exe to C:\cxmpute\
3. Add C:\cxmpute\ to your PATH environment variable
4. Restart Command Prompt/PowerShell
5. Run: cxmpute-provider

Commands & Controls

Basic Commands

# Start the provider
cxmpute-provider

# Stop the provider
# Press Ctrl+C in the terminal

Advanced Usage

• The CLI handles all complex operations automatically
• No manual configuration required
• Updates are handled through new releases

Support

Getting Help

• Discord: Join our community for real-time support
• GitHub: Report issues on our repository
• Email: Contact support@cxmpute.cloud

Community

Join our Discord for:

• Latest news and updates
• Provider tips and tricks
• Community support
• Feature announcements

Next Steps

1. 📊 Monitor Earnings: Keep track of your progress in the dashboard
2. 👥 Invite Friends: Use the referral system to boost earnings
3. ⬆️ Upgrade Hardware: Consider hardware improvements for higher tiers
4. 🌍 Join Community: Connect with other providers on Discord

Ready to start earning? Download the CLI and join thousands of providers powering the Cxmpute network!