SpareTokens

Install SpareTokens

One command for macOS, Linux and Windows through WSL2. The package is built and checked, and ships at launch.

Read the quickstartGet started

Available at launch The worker package is built, checked and ready, but not published yet. The commands below are exactly what you will run on launch day, so they will not work until then. Get started to be told when they do. Invited to the private beta? Your dashboard gives you a private install command that uses this installer with a link only your account can use.

Install SpareTokens

One command per system. Pick yours; every option installs the same sparetokens command and nothing starts running until you run sparetokens setup. You need Python 3.10 or newer (the installer checks), and macOS, Linux or Windows. See system requirements.

macOS

The macOS sandbox (sandbox-exec) is built in, so there is nothing else to install.

Homebrew Available at launch

brew install pfergi42/sparetokens/sparetokens

pipx Available at launch

brew install pipx
pipx install sparetokens

One-line installer Available at launch

curl -fsSL https://sparetokens.ai/install.sh | sh

Linux

Install bubblewrap for the sandbox that shell and solver tasks use: sudo apt install bubblewrap on Debian and Ubuntu, or sudo dnf install bubblewrap on Fedora. Without it the worker still runs, but offers no shell tasks.

pipx Available at launch

pipx install sparetokens

Homebrew on Linux Available at launch

brew install pfergi42/sparetokens/sparetokens

One-line installer Available at launch

curl -fsSL https://sparetokens.ai/install.sh | sh

Windows

The best path is WSL2 (Windows Subsystem for Linux), which is a real Linux, so the full sandbox works. Open PowerShell and run:

wsl --install -d Ubuntu

Restart if asked, open Ubuntu from the Start menu, then follow the Linux steps above inside it. The one-line installer runs there.

Native Windows also works for tasks that need no shell, such as literature checks. In PowerShell:

pipx install sparetokens

Available at launch Shell and solver tasks are refused on native Windows with a pointer back to WSL2, because there is no sandbox we trust there. See what works on each system.

Check that it worked

sparetokens --version
sparetokens doctor

sparetokens doctor is a read-only self-check. It reports your operating system, whether a sandbox is available, which providers it found, what the provider terms allow, where your config lives and whether the coordinator answers. On macOS it also suggests keeping a provider key in the Keychain (keychain:) when a source reads it from an environment variable (env:). It never prints a key and changes nothing. Add --offline to skip the network check or --json for a machine-readable report.

Then continue with the quickstart.

How the installer proves what it downloads

Each release publishes a SHA256SUMS file next to the wheel, the pinned constraints.txt and the installer. The one-line installer downloads them, checks the SHA-256 of what it fetched, and stops without installing anything if a checksum does not match. It prints what it will do first and asks you to confirm (use --yes to skip the question). It never runs as root and never uses sudo.

If you want to read before you run, download the script and open it: curl -fsSLO https://sparetokens.ai/install.sh, then sh install.sh --dry-run prints the plan and changes nothing. You can also give it the checksum you expect with --sha256. Release files are signed with Sigstore, so you can verify them yourself with cosign verify-blob.

What to do next

Follow the guide that matches what you have. Each one is a single page that ends at your first verified result: API credit, a local model with Ollama, your own AI agent or a company or lab. The chooser helps you pick.

Remove it

Run sparetokens uninstall first to remove the background service and local config, then pipx uninstall sparetokens or brew uninstall sparetokens.