Pool Do
Get Started with Pool Do
Pool Do lets you pool idle compute with others. This guide walks you through creating an account, installing the worker, and submitting your first task.
1. Create an Account
Head to your Pool Do instance and register:
- Navigate to the Register page
- Enter your email, display name, and a password (8+ characters)
- If you have an invite code from a pool admin, enter it now — you'll be automatically added to their pool
Once registered, you'll be signed in and taken to the Pools dashboard.
2. Join or Create a Pool
Pools are groups of machines that share compute. You need to be in at least one pool to submit or process tasks.
- Join an existing pool — browse the "All Pools" list on the dashboard, or use an invite code
- Create a new pool — click "Create New Pool", give it a name, and invite your team
3. Install the Worker
The worker daemon runs on your machine and processes tasks from pools you belong to.
Download
Download the latest pooldo-worker binary for your platform:
# macOS (Apple Silicon)
curl -L https://github.com/Pythia-Software/pooldo/releases/latest/download/pooldo-worker-darwin-arm64 -o pooldo-worker
chmod +x pooldo-worker
Configure
The worker needs to know where your Pool Do server is and how to authenticate:
export POOLDO_SERVER_URL="https://your-pooldo-instance.example.com"
export POOLDO_API_KEY="your-api-key"
You can find your API key on your Profile page in the web UI.
Run
./pooldo-worker
The worker will automatically detect local model backends (Ollama, llama.cpp, MLX, LM Studio) and register itself with the server. You'll see it appear on the Workers page.
4. Submit Your First Task
Now that you have a worker running, you can submit tasks. Pool Do supports three interfaces:
- Web UI — point-and-click task submission in your browser
- CLI — submit tasks from the command line
- API — programmatic access for scripts and integrations
What's Next?
- Learn about submitting tasks via the CLI for batch workflows
- Understand how credits and quotas work
- Check out the API reference for building integrations