Justin0504 / Sovereign-OS
Constitution-first AI orchestration: one Charter (YAML) defines mission, budget & rules. CEO plans → CFO approves → Ledger tracks every cent & token → Auditor scores. 16 workers, Stripe, MCP. Think. Audit. Execute.
Why this job: topics: agent-framework, orchestration, ai-agents

What it does
- Charter-driven. mission, competencies, KPIs, fiscal boundaries — all in one YAML.
- CEO (Strategist) decomposes natural-language goals into executable task plans with dependencies. Reactive: prune_to_budget sheds lowest-value tasks to fit a budget without breaking the dependency DAG; corrective_task builds a high-priority
- Profitability-first task selection. before spending any compute, an ingest screen (governance/economics.py) estimates a task's fully-loaded cost (LLM by category × complexity + settlement fee + gas) and skips anything that can't clear the
- Reactive self-repair. a task that fails audit is automatically re-run with the Auditor's reason + fix folded into its brief (SOVEREIGN_MAX_REPAIR_ATTEMPTS=N), recovering quality with no human in the loop. Only a fully-passing mission reach
- CFO (Treasury) enforces max_task_cost_usd, daily_budget_usd, runway_days, and min_job_margin_ratio *before* any task runs. A runtime SpendCircuitBreaker adds fast-fail *during* a session — it halts the loop when cumulative spend hits a sess
Get started
pip install -e .
sovereign run --charter charter.example.yaml "Summarize the current AI agent landscape."- Maintenance
- Active
- Last commit 3 days ago
- Stars
- 105
- On GitHub
- Licence
- MIT
- Allows business use
- Downloads for
- None listed
- No release files
- Latest version
- None yet
- No releases
- Built with
- Python
- 89% of the code
Is it looked after?
- Contributors
- 1
- Last 90 days
- Issues
- None
- No issues filed
- Pull requests
- 2 merged
- 0 waiting
- Releases
- None
- Never published
- Contributing guide (opens in new tab)
- Security policy (opens in new tab)
- No code of conduct
Similar repos
| Repo | Stars | Last commit | Licence | Downloads for |
|---|---|---|---|---|
| OrlojHQ / orloj | 126 | 22 days ago | Apache-2.0 | Mac, Windows, Linux |
More: languages, topics and project record
Languages
- Python 89%
- HTML 10%
- TypeScript <1%
- Shell <1%
Topics
- agent-framework
- ai-agents
- ai-governance
- arxiv
- audit-trail
- constitution-first
- orchestration
- stripe
Project record
- JobAgent frameworks
- StatusListed
- Commits250
- Forks14
- Watching5
- Stars in 28 days+12
- CreatedMar 4, 2026
- First seen by usNov 7, 2026
- CheckedNov 7, 2026
