Measured cost prediction

Know what the work costs before it runs.

Agent budgets are guesses, and nobody checks them. We measured ours across 49 governed runs — then fixed what the measurement found.

No key, no signup — one click runs the real budget, permission and audit gates, refusals and all.

Runs on your machine Bring your own keys Your work stays yours

Predicted cost was flat. Real cost was not.

49 governed runs · 3 repeats · claude-haiku-4-5
Predicted Actual
0¢ 2¢ 4¢ 6¢ 8¢ Small: predicted 3.71¢ 3.71¢ Small: actual 1.96¢ (n=17) 1.96¢ Small n=17 Medium: predicted 4.14¢ 4.14¢ Medium: actual 3.69¢ (n=14) 3.69¢ Medium n=14 Large: predicted 4.33¢ 4.33¢ Large: actual 7.05¢ (n=18) 7.05¢ Large n=18

Across work whose real cost moved 3.6×, the estimate moved 1.17× — it read the goal's string length, not the work. 97% of that error is systematic, not run-to-run noise. Estimating from the planner's task graph instead cuts the scatter 47% and lands 94% of predictions within 2×.

Show the numbers
Task sizePredictedActualn
Small3.71¢1.96¢17
Medium4.14¢3.69¢14
Large4.33¢7.05¢18
49
governed runs measured, over three repeats
97%
of the estimate error is systematic, not noise
47%
less scatter when estimating from the task graph
94%
of predictions land within 2× of real cost
The loop

Every action is scoped, approved, verified, and receipted.

A declarative charter defines the mission, the money, and what counts as done. Everything after flows through four gates — no task consumes a dollar or a permission it hasn't earned.

01 · PLAN

Decompose

A goal becomes a dependency-aware task graph, each task mapped to a declared competency and a token budget.

02 · GOVERN

Budget & permission

Each task clears the budget, daily-burn, and margin checks, and runs only under a just-in-time permission that expires when it's done.

03 · DELIVER

Verify the work

Outputs are graded against a category-tuned rubric; code isn't accepted until its tests pass, and a failed task self-repairs before it ships.

04 · SETTLE

Receipt & pay

Every report is sealed with a SHA-256 proof hash in an append-only ledger; settlement runs over Stripe or x402/USDC.


Why teams run it

Governance built into the infrastructure, not bolted on.

Budget control

Per-task ceilings, a daily burn cap, a runway floor, and a session circuit breaker that fast-fails a runaway loop before it drains the account.

spend ≤ cap · breaker · runway

Authority that survives a handoff

Agents earn capabilities through a track record, and when one hands work to another — a sub-agent, an MCP tool, Claude Code — the grant can only narrow. A child spends its parent's budget, never a fresh one, and revoking a parent revokes everything carved from it.

attenuation · conservation · cascading revocation

Tamper-evident audit

Every deliverable is verified against the charter's success criteria and sealed with a SHA-256 proof hash in an append-only ledger you can verify offline.

proof_hash · append-only

Works inside the tools you already use

One entry in your MCP config and Claude Code or Claude Desktop runs under a budget check, scoped authority, and a verifiable receipt. No tool on that surface can raise a budget or grant a capability — the levers stay in the charter, where an agent cannot reach them.

MCP server · 4 tools · no escape hatch
Delivery capabilities

One workspace, the work your team actually ships.

Coding
bug fixes · PRs · verified
Research
web-grounded · cited
Writing
articles · emails
Data
analysis · reports
Design
briefs · specs
Automation
workflows · specs
Your keys · your money

You bring the keys. It never holds the funds.

Sovereign-OS runs on your own machine and your own LLM key, and settles — when you choose to — through your own Stripe account or wallet. It is the control plane — budgets, permissions, audit — not a custodian. Your spend bills your key; your revenue lands in your account.

Bring your own keys
LLM, Stripe, and wallet are yours — kept in your environment, used only for your missions.
Runs where you run it
Self-hosted on your machine or your cloud. No data leaves your box; nothing is sent to us.
Open source under MIT
Read every line, fork it, run it forever. No lock-in, no commission on your work.
Quickstart

Running on your machine in about a minute.

Self-hosted and open source. Your keys live in your own environment — nothing leaves your box. Start the governed workspace, then open it in the browser.

01
Bring your keys
Set your own ANTHROPIC_API_KEY — agents run on your account, metered by your charter.
02
Start the workspace
One command brings up the web console and its append-only ledger.
03
Run a mission
Open localhost:8000, state a goal, and watch it clear the four gates.
your machine · ~/sovereign-os
# Docker — the whole workspace
$git clone github.com/Justin0504/Sovereign-OS
$export ANTHROPIC_API_KEY=sk-ant-…
$docker compose up -d redis web
→ console live at http://localhost:8000 ✓
 
# or inside Claude Code — no runtime to adopt
$pip install 'sovereign-os[mcp]'
  # add to .mcp.json: python -m sovereign_os.mcp.server
 
# or without Docker
$pip install -e .
$python -m sovereign_os.web.app 8000
Editions

Free and open source. Host it yourself.

The whole governed control plane is MIT-licensed and yours to run — your machine, your keys, your data. A managed edition is live for teams who'd rather not operate it — bring your key, keep your data, start free.

Open source
Solo
$0 · MIT
  • The full governance loop & audit ledger
  • Unlimited missions — on your own keys
  • Web console + terminal UI
  • Docker & pip, up in a minute
Run it yourself
Team · self-hosted
$0 · MIT
  • Everything in Solo
  • Multi-tenant workspaces, isolated per seat
  • Prometheus / Grafana metrics
  • Delegate to Claude Code & Codex
Read the docs
Hosted
Live · free to start
  • Fully managed — we run the infra
  • Bring your own key, encrypted at rest
  • Isolated workspace · rotate / export / delete
  • 20 free missions a day, no card
Open the console
Settles over the rails agents use
x402 · USDC on Base Stripe · cards APB · agent payment bounties TaskBounty StacksTasker RentAHuman
Ship work you can trust

Give every agent a budget, a boundary, and a verifiable receipt.

Open source, MIT-licensed, and running in under five minutes — on your machine, on your keys. Put your AI workforce under a charter.