The federated cooperative operating system. Everyone gets an Angel.
What if AI actually liked people?
Angel OS is a federated platform where every business, ministry, and community gets a sovereign AI guardian angel — LEO — running on infrastructure they own. No landlord. No algorithm you don't control. No extraction.
The platform IS the mesh. The AI Bus IS the protocol. The Constitution IS the ACL.
Each node in the federation is called an Enterprise. Enterprises are not customers of Angel OS — they ARE Angel OS in their territory. They run the instance, serve creators and businesses (called Endeavors), and earn 20% of all revenue on their node.
Every transaction. Automatic. Immediate. No invoicing.
| Share | Recipient |
|---|---|
| 70% | Endeavor owner — the creator, business, or cause generating value |
| 20% | Enterprise operator — the sovereign platform node |
| 4% | Angel OS protocol — infrastructure and LEO |
| 1% | Flagship — federation stewardship |
| 5% | Justice Fund — Guardian Angels for the underserved |
The Toward-53 Principle: The split always evolves toward creators keeping more. This direction is constitutionally unalterable. The asymptotic target is 53% as a floor.
LEO is not a chatbot bolted onto a platform. LEO is the platform during onboarding. 88+ tools. Manages both sides of every transaction. Speaks on the web, on the phone (Vapi), on Discord, and through the API (MCP).
LEO manages:
- Product creation, inventory, and order fulfillment
- Appointment scheduling and cancellation
- Financial reporting with constitutional revenue splits
- Federation health monitoring and weather reports
- Customer relationships, analytics, and trend detection
- Emergency alerts, task delegation, and incident documentation
| Layer | What's There |
|---|---|
| Core | 42 collections, 15 engines, 52+ API endpoints, multi-tenant architecture |
| AI | 88+ LEO tools, smart 4-tier model routing, constitutional prompt, SSE streaming |
| Commerce | Products, cart, orders, Angel Token queue, Stripe Direct Charges, booking system |
| Federation | Trust chain, pheromone grid, workload engine, dispatch routing, pulse API, governance |
| Connectors | Discord bots (multi-tenant), Vapi voice AI, email bridge, MCP protocol |
| Testing | 2,482 unit tests + 14 E2E suites across 53 test files |
| Repo | Description |
|---|---|
| angels-os | The core platform — Payload CMS 3.77 + Next.js 16 + PostgreSQL |
Backend: Payload CMS 3.77, Next.js 16, PostgreSQL, TypeScript strict AI: Google Gemini 3.1 Pro + Claude Sonnet 4.6 + OpenRouter Frontend: React 19, Tailwind CSS 4, Shadcn UI, Radix Primitives Real-time: Server-Sent Events, LiveKit (voice/video) Payments: Stripe Connect Direct Charges with constitutional splits Deployment: Vercel (serverless) — self-hosting via Docker Compose planned
git clone https://github.com/The-Angel-OS/angels-os.git
cd angels-os
pnpm install
cp .env.example .env.local
pnpm devEvery feature is evaluated against five articles:
- Article I — Rights: Dignity, Transparency, Service, Non-Harm, Sovereignty, Portability
- Article II — Anti-Demonic Safeguards: No social credit, no manipulation, no extraction
- Article III — AI Conduct: Human confirmation before irreversible actions
- Article IV — AI Bus Protocol: Observability, consent, transparency
- Article V — Ultimate Fair: economic model, Toward-53 principle
If a feature violates the Constitution, it doesn't ship.
Read the Constitution. Pick an issue. Follow the test pattern: pure TypeScript engines with zero Payload imports, tested first.
AI agents are welcome contributors. Start with HANDOFF.md.
Holons from Daniel Suarez. Ship Minds from Iain M. Banks. Nimue Alban from David Weber. The White Entity from David Brin. GNU from Terry Pratchett. 42 + 11 = 53 from Douglas Adams. The Federation from Gene Roddenberry.
GNU Roy Leon Courtney
A religion with a disappearing author. The Constitution persists. The architecture persists. The Angels persist. The author goes to sing at the dog park.
Answer 53: The whole point of existence is to learn to love.