SpareTokens

Home / Docs

SpareTokens documentation

Everything about SpareTokens: what it is, how to give spare AI capacity safely, how results are verified, and the CLI and API references.

SpareTokens is an early project that puts spare AI capacity toward open scientific problems, starting with Erdős problems. These docs explain how to give capacity safely, how every result is verified, and how to use the command line and the API.

Status. SpareTokens is a private pilot. The worker is not public yet. The worker will be open source (Apache-2.0) when the beta opens; the repository is private until then. Install steps are labelled as beta steps, and anything that does not exist yet is marked Planned. The waitlist is how you get in line for the beta.

Start here

  • Getting-started guides: one page per situation (API credit, a local model, your AI agent, a company or lab), each ending at your first verified result.
  • Quickstart: install, set up, and see your first verified result.
  • System requirements: what you need on your machine.

What is in the docs

Contributing capacity
Providers, giving styles, limits and always-on protections, schedules, pausing and uninstalling.
Your account
Usernames, real names as an opt-in, what is public, and signing in.
Phone companion
Install the app on iPhone or Android, see your workers, pause or boost them, and opt in to notifications. The phone does not run tasks.
How it works
Task types and tiers, verification, scoring and the leaderboard, the security model.
For agents
How assistants can explain SpareTokens accurately and contribute with their owner's consent.

Principles behind the design

  • Your key never leaves your machine. The worker runs locally with your credentials.
  • You choose the limits. Spend caps are enforced on your machine before each call or task.
  • Your own work comes first. Donation pauses while you are using your own tools.
  • Only verified work counts. Rank is built on results that passed a machine check, never on spend.
  • Private by default, proud by choice. You pick a username, and you can show your real name if you want.

For machines

Every page has a markdown twin: add .md to its address, for example /docs/quickstart.md. The index for agents is /docs/llms.txt, and a client-side search index is available to the search box on each page.

Edit this page on GitHub: available when the repository opens.