**AGI-OS**

The **agi-os** repository is the monorepo backbone of Phase Mirror ---
an ambitious, multi-layer operating system designed to sit at the
intersection of AGI orchestration, cryptographic verification, and
on-chain governance. It\'s not just a software project; it\'s a
philosophy of how AI systems should be built: with **productive tension
baked in**, not smoothed away.

**The Tech Stack Is Deliberately Polyglot**

The repo speaks multiple languages simultaneously --- and that\'s
intentional. You\'ll find
[[Cargo.toml]{.underline}](https://github.com/PhaseMirror/agi-os/blob/4268fb879d43ea424250e1949a9c678090afa14a/Cargo.toml)
signaling **Rust** for performance-critical and cryptographic core work,
[[package.json]{.underline}](https://github.com/PhaseMirror/agi-os/blob/4268fb879d43ea424250e1949a9c678090afa14a/package.json)
and
[[next.config.mjs]{.underline}](https://github.com/PhaseMirror/agi-os/blob/4268fb879d43ea424250e1949a9c678090afa14a/next.config.mjs)
driving a **Next.js / TypeScript** frontend, and
[[pyproject.toml]{.underline}](https://github.com/PhaseMirror/agi-os/blob/4268fb879d43ea424250e1949a9c678090afa14a/pyproject.toml)
anchoring **Python** for research and ML pipelines. Even Solidity is
present via
[[hardhat.config.ts]{.underline}](https://github.com/PhaseMirror/agi-os/blob/4268fb879d43ea424250e1949a9c678090afa14a/hardhat.config.ts)
and
[[foundry.toml]{.underline}](https://github.com/PhaseMirror/agi-os/blob/4268fb879d43ea424250e1949a9c678090afa14a/foundry.toml)
--- smart contracts are a first-class citizen here.

**The Core Intelligence Layers**

Several directories reveal the project\'s conceptual heart. The
[[mirror-dissonance-pro]{.underline}](https://github.com/PhaseMirror/agi-os/tree/4268fb879d43ea424250e1949a9c678090afa14a/mirror-dissonance-pro)
directory is the flagship library --- **dissonance** is the signal Phase
Mirror listens for, not tries to eliminate. The
[[multiplic]{.underline}](https://github.com/PhaseMirror/agi-os/tree/4268fb879d43ea424250e1949a9c678090afa14a/multiplic)
and
[[multiplicity]{.underline}](https://github.com/PhaseMirror/agi-os/tree/4268fb879d43ea424250e1949a9c678090afa14a/multiplicity)
directories directly implement Multiplicity Theory --- the prime-indexed
mathematical framework underlying the system\'s cognition model.
Supporting these are
[[ensemble]{.underline}](https://github.com/PhaseMirror/agi-os/tree/4268fb879d43ea424250e1949a9c678090afa14a/ensemble),
[[meta\_ensembles]{.underline}](https://github.com/PhaseMirror/agi-os/tree/4268fb879d43ea424250e1949a9c678090afa14a/meta_ensembles),
and
[[engine]{.underline}](https://github.com/PhaseMirror/agi-os/tree/4268fb879d43ea424250e1949a9c678090afa14a/engine)
--- a recursive, multi-agent reasoning stack.

**Cryptography and Chain Integration**

This isn\'t just AI --- it\'s **verifiable AI**. The
[[circuits]{.underline}](https://github.com/PhaseMirror/agi-os/tree/4268fb879d43ea424250e1949a9c678090afa14a/circuits)
and
[[circuit]{.underline}](https://github.com/PhaseMirror/agi-os/tree/4268fb879d43ea424250e1949a9c678090afa14a/circuit)
directories contain zero-knowledge proof circuits, and the
[[native-proof]{.underline}](https://github.com/PhaseMirror/agi-os/tree/4268fb879d43ea424250e1949a9c678090afa14a/native-proof)
directory suggests on-device proof generation. The
[[bitcoin]{.underline}](https://github.com/PhaseMirror/agi-os/tree/4268fb879d43ea424250e1949a9c678090afa14a/bitcoin)
directory and
[[SOLANA\_OPERATIONAL\_RUNBOOK.md]{.underline}](https://github.com/PhaseMirror/agi-os/blob/4268fb879d43ea424250e1949a9c678090afa14a/SOLANA_OPERATIONAL_RUNBOOK.md)
confirm multi-chain ambitions --- both Bitcoin and Solana are live
infrastructure targets, alongside Ethereum Sepolia testnet configs in
[[.env.sepolia.example]{.underline}](https://github.com/PhaseMirror/agi-os/blob/4268fb879d43ea424250e1949a9c678090afa14a/.env.sepolia.example).

**Governance as Architecture**

What separates agi-os from typical AI repos is how seriously it treats
governance as a *technical artifact*, not a policy afterthought.
There\'s a dedicated
[[governance]{.underline}](https://github.com/PhaseMirror/agi-os/tree/4268fb879d43ea424250e1949a9c678090afa14a/governance)
directory, a
[[COVENANT.md]{.underline}](https://github.com/PhaseMirror/agi-os/blob/4268fb879d43ea424250e1949a9c678090afa14a/COVENANT.md)
(20KB --- this is substantial), a
[[CONTRIBUTING-GOV.md]{.underline}](https://github.com/PhaseMirror/agi-os/blob/4268fb879d43ea424250e1949a9c678090afa14a/CONTRIBUTING-GOV.md),
and even a
[[LICENSING-POLICY.md]{.underline}](https://github.com/PhaseMirror/agi-os/blob/4268fb879d43ea424250e1949a9c678090afa14a/LICENSING-POLICY.md)
separating open-core from proprietary modules. The
[[proprietary]{.underline}](https://github.com/PhaseMirror/agi-os/tree/4268fb879d43ea424250e1949a9c678090afa14a/proprietary)
directory sits right next to the open-source code --- a live expression
of the open-core business model tension.

**Regulatory Ambition**

Perhaps the most surprising file is
[[FDA\_SUBMISSION\_QUICK\_REFERENCE.md]{.underline}](https://github.com/PhaseMirror/agi-os/blob/4268fb879d43ea424250e1949a9c678090afa14a/FDA_SUBMISSION_QUICK_REFERENCE.md)
--- 9KB of FDA regulatory guidance sitting in an AGI operating system
repo. This signals the project is building toward domains where **AI
decisions carry clinical or life-critical weight**, requiring formal
regulatory approval paths.

**MCP and Agent Infrastructure**

The
[[mcp]{.underline}](https://github.com/PhaseMirror/agi-os/tree/4268fb879d43ea424250e1949a9c678090afa14a/mcp)
and
[[mcp\_server]{.underline}](https://github.com/PhaseMirror/agi-os/tree/4268fb879d43ea424250e1949a9c678090afa14a/mcp_server)
directories implement the **Model Context Protocol** layer --- the
connective tissue between AI agents and external systems. The
[[AGENTS.md]{.underline}](https://github.com/PhaseMirror/agi-os/blob/4268fb879d43ea424250e1949a9c678090afa14a/AGENTS.md)
file (9.7KB) defines the agent contract surface, and the
[[.agent.md]{.underline}](https://github.com/PhaseMirror/agi-os/blob/4268fb879d43ea424250e1949a9c678090afa14a/.agent.md)
at the root functions as a runtime instruction set for any AI
collaborating on the codebase itself --- meta-governance for the
builders.

**The one-sentence podcast hook:** *agi-os is a monorepo that treats
contradiction --- between open and proprietary, between AI speed and
regulatory caution, between local inference and cloud scale --- not as a
problem to solve, but as the actual source of the system\'s
intelligence.*
