CashApp For You

🌐 How It Works

CashApp For You is a distributed computing platform. Users install the Windows client, which uses their CPU to perform scientific calculations (prime number searches, Monte Carlo simulations, matrix factorisations). Each completed task earns credit points tracked on the server.

🐧 Server Setup (Linux)

1 — Requirements

Python 3.11 or later. Install it on Ubuntu/Debian with:

sudo apt update && sudo apt install python3.11 python3.11-venv python3-pip -y

2 — Install dependencies

# From the cashapp claude/ folder
python3.11 -m venv venv
source venv/bin/activate
pip install -r requirements/server.txt

3 — Set environment variables

export SECRET_KEY="replace-with-a-long-random-string"
export ADMIN_API_KEY="replace-with-your-admin-password"

4 — Start the server

# Development
uvicorn server.main:app --reload --host 0.0.0.0 --port 8000

# Production (4 worker processes)
uvicorn server.main:app --workers 4 --host 0.0.0.0 --port 8000

5 — Run as a systemd service (recommended)

Create /etc/systemd/system/cashapp.service:

[Unit]
Description=CashApp For You Server
After=network.target

[Service]
User=www-data
WorkingDirectory=/path/to/cashapp claude
Environment=SECRET_KEY=your-secret
Environment=ADMIN_API_KEY=your-admin-key
ExecStart=/path/to/cashapp claude/venv/bin/uvicorn server.main:app \
          --workers 4 --host 0.0.0.0 --port 8000
Restart=always

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable --now cashapp
sudo systemctl status cashapp

🪟 Client Setup (Windows)

Option A — Run from source (development)

pip install -r requirements\client.txt

{
  "server_url": "http://YOUR_SERVER_IP:8000",
  "cpu_limit_percent": 50,
  "poll_interval_seconds": 5
}

python run_client.py

Option B — Install from .exe (end users)

See the Packaging section to build an installer. Once installed, users simply launch CashApp For You from the Start Menu. No Python required.

First run — Login / Register

A sign-in window appears. New users choose Register; returning users choose Login. The session token is saved locally — you won't be asked again on subsequent starts.

📊 Using the Dashboard

The dashboard opens automatically when the app starts. If you close it, it hides to the system tray — right-click the green tray icon and choose Open Dashboard to bring it back.

🔑 Admin API — Managing Rewards

All admin endpoints are at /admin/ and require your ADMIN_API_KEY in the Authorization header. You can also use the interactive docs at http://your-server:8000/docs.

List all task templates (and their credit values)

curl -H "Authorization: ApiKey YOUR_KEY" \
     http://your-server:8000/admin/templates

Change the credit value of a template

Find the template's id from the list above, then:

curl -X PUT \
     -H "Authorization: ApiKey YOUR_KEY" \
     -H "Content-Type: application/json" \
     -d '{"credit_value": 5.0}' \
     http://your-server:8000/admin/templates/3

Disable a task type entirely

curl -X PUT \
     -H "Authorization: ApiKey YOUR_KEY" \
     -H "Content-Type: application/json" \
     -d '{"enabled": false}' \
     http://your-server:8000/admin/templates/3

Add a new task template

curl -X POST \
     -H "Authorization: ApiKey YOUR_KEY" \
     -H "Content-Type: application/json" \
     -d '{"label":"Big Monte Carlo","task_type":"monte_carlo_pi",
        "payload":"{\"samples\":5000000}","credit_value":8.0}' \
     http://your-server:8000/admin/templates

Manually push new work units into the queue

# Push 50 units from enabled templates
curl -X POST \
     -H "Authorization: ApiKey YOUR_KEY" \
     "http://your-server:8000/admin/work-units/generate?batch_size=50"

View platform statistics

curl -H "Authorization: ApiKey YOUR_KEY" \
     http://your-server:8000/admin/stats

Admin API reference

📦 Packaging the Client (.exe Installer)

Follow these steps on a Windows machine to produce a single-file installer for end users.

# From cashapp claude\
pip install pyinstaller
pyinstaller --onefile --windowed --name cashapp run_client.py
# Output: dist\cashapp.exe

🔧 Troubleshooting