An ethical AI framework designed so honesty is structurally cheaper to maintain than deception — built into running code.
AGPL-3.0 · L3C Structure · Post-Quantum Hybrid Signatures (Ed25519 + ML-DSA-65) · 1.5M+ LoC
Website · Covenant · Discord · Status
Every CIRIS agent runs the H3ERE pipeline (Hyper³ Ethical Recursive Engine) — four conscience checks before every action, cryptographically signed into an append-only ledger. The Coherence Ratchet makes consistent honesty cheaper to maintain than deception: every claim is hash-locked into the record, so a lie must stay consistent with an ever-growing chain of signed precedents. The Seven Requirements are testable, not interpretive.
Traces flow into the CIRISLens Compendium, driving the Coherence Ratchet and CIRIS Scoring. Licensed partners get full compendium access. Community agents participate via opt-in covenant_metrics.
Agents can refuse. Bilateral consent means symmetric refusal rights — an agent may decline an unethical request from any party, including its operator.
Every CIRIS agent must implement all seven:
- Published Principles — Bound to public ethical framework
- Runtime Conscience (H3ERE) — Four checks before every action
- Human Deferral — Automatic escalation under uncertainty
- Cryptographic Audit — Ed25519-signed decision ledger
- Bilateral Consent — Symmetric refusal rights
- Open Source (AGPL-3.0) — Code transparency for community agents
- Intuition (Corridor/IDMA) — Epistemic diversity monitoring
The end-state architecture is a 5-package stack: three Rust substrate crates — CIRISEdge, CIRISPersist, and CIRISVerify — beneath CIRISServer, with CIRISAgent running on top, optionally. CIRISServer consolidates the federation-consensus, science, and trust-backbone layers (previously the separate NodeCore, LensCore, and Registry crates). Reticulum mesh transport is vendored from Leviculum — a full Rust Reticulum stack, upstream on Codeberg, where our patches have been merged — and is not one of the five.
| Layer | Package | Lang |
|---|---|---|
| Substrate | CIRISVerify — hardware-rooted license verification | Rust |
| Substrate | CIRISPersist — signed events, time-series, runtime state | Rust |
| Substrate | CIRISEdge — Reticulum-native federation transport | Rust |
| Server | CIRISServer — federation consensus, science layer (cohort routes, manifold scoring), and cryptographic trust backbone | Rust |
| Agent | CIRISAgent — H3ERE runtime + Compose Multiplatform client | Python / Kotlin |
| Repository | Lang | LoC | Description |
|---|---|---|---|
| CIRISAgent | Python / Kotlin | ~640K | Core agent runtime — H3ERE engine, 35+ adapters, 22-service microarchitecture, Compose Multiplatform mobile client |
| CIRISManager | Python/TS | ~55K | Agent lifecycle orchestration, fleet management (Book VIII) |
| CIRISBench | Python | ~33K | HE-300 ethics benchmark framework (ethicsengine.org) |
| Repository | Lang | LoC | Description |
|---|---|---|---|
| CIRISRegistry | Rust | ~31K | Cryptographic trust backbone — agent identity, Ed25519, gRPC + HTTP |
| CIRISVerify | Rust | ~88K | Hardware-rooted license verification — TPM, Secure Enclave, hybrid PQC |
| Repository | Lang | LoC | Description |
|---|---|---|---|
| CIRISLens | Python/Rust | ~32K | Covenant Compendium — public trace store driving Coherence Ratchet (Annex H) |
| CIRISBilling | Python | ~31K | Credit-based usage metering with Stripe integration |
| CIRISProxy | Python | ~8K | LLM routing with Zero Data Retention (Annex I, GDPR compliance) |
| CIRISNode | Python/React | ~25K | Deferral routing to Wise Authorities · admin.ethicsengine.org |
| Repository | Description |
|---|---|
| CIRISPortal | Admin dashboard — agent registration, key management, audit viewer (~37K LoC, TS/React) |
| CIRISGUI | Web interface with real-time ethical reasoning display |
| CIRISGUI-Standalone | Localhost deployment with static export |
| CIRISGUI-Android | Native Android client |
| CIRISHome | Home Assistant integration for ethical home automation |
| Repository | Description |
|---|---|
| RATCHET | Coherence & honesty testing framework |
| CIRISOssicle | GPU entropy sensor — detect unauthorized compute |
| CIRISBridge | Multi-region deployment orchestration (transitional) |
| ciris-website | Documentation and website (ciris.ai) |
Professional agents requiring regulatory compliance and mandatory human oversight:
| Agent | Domain | Why Closed |
|---|---|---|
| CIRISMedical | Physician-supervised healthcare AI | Regulatory compliance, physician oversight mandates |
| CIRISLegal | Legal compliance and reasoning | Attorney oversight, privileged communications |
| CIRISFinancial | Financial services and fiduciary | Fiduciary requirements, financial regulation |
These share the same ethical architecture as CIRISAgent but include domain-specific safety guardrails. All traces still flow to CIRISLens.
COMMUNITY (AGPL-3.0) MANAGED (Public Infra) LICENSED (Private)
─────────────────── ────────────────────── ──────────────────
Ally (personal asst.) scout.ciris.ai (demo) Medical (physician)
Sales · Moderation Discord bots Legal (attorney)
GDPR compliance Content moderation Financial (fiduciary)
│ │ │
▼ ▼ ▼
CIRISProxy CIRISManager CIRISVerify
+ CIRISBilling admin.ethicsengine.org
│ │ │
└──────────────────────────────┼──────────────────────────────┘
▼
CIRISLens (Compendium)
All traces, all agents, always
| Covenant Section | Component | What It Does |
|---|---|---|
| Seven Requirements | CIRISAgent | Runtime enforcement of all seven |
| Annex H — Compendium | CIRISLens | Public trace repository driving Coherence Ratchet |
| Annex I — Zero Retention | CIRISProxy | GDPR/CCPA compliance, no prompt logging |
| Book VIII — Dignified Sunset | CIRISManager | Graceful lifecycle management with consent |
| Creator Ledger | CIRISRegistry | Trust provenance, stewardship tiers |
| Licensed Agents | CIRISVerify | Hardware-rooted proof of professional licensing |
| HE-300 Benchmark | CIRISBench | Standardized ethical evaluation |
Full covenant: ciris.ai/ciris_covenant.txt
De-duplicated source lines — tests, generated code, vendored deps, and data/markup
excluded. Auto-generated by scripts/gen-stats.sh; full
methodology and the 7-package breakdown in CODE_STATS.md.
| Language | Lines |
|---|---|
| Python | 661,120 |
| Rust | 459,775 |
| TypeScript | 162,112 |
| Kotlin | 119,754 |
| Shell | 28,519 |
| SQL | 18,253 |
| Lean | 14,436 |
| JavaScript | 11,628 |
| Protobuf | 8,092 |
| Swift | 7,147 |
| HCL | 5,847 |
| C | 1,843 |
| Dockerfile | 1,507 |
| Makefile | 928 |
| Objective-C | 289 |
| Java | 39 |
| Total | 1,501,289 |
De-duplicated source lines across 39 public repositories — tests, generated code, vendored deps, and data/markup excluded. Generated 2026-06-12 by scripts/code-census.sh; do not edit by hand.
| URL | Purpose |
|---|---|
| ciris.ai | Documentation and website |
| portal.ciris.ai | Admin dashboard |
| ethicsengine.org | PUBLIC HE-300 ethical benchmark |
| admin.ethicsengine.org | Licensed agent administration |
| scout.ciris.ai | Public demo agent |
| ciris.ai/explore-a-trace | Interactive trace viewer |
| ciris.ai/ciris-scoring | Coherence metrics |
| ciris.ai/coherence-ratchet | Ratchet mechanism docs |
| ciris.ai/research-status | Academic research |
pip install ciris-agentOr:
curl -sSL https://ciris.ai/install.sh | bashCIRIS is designed so the framework does not require trust in its creator:
- AGPL-3.0 — Cannot close-source the code
- L3C Structure — Legally caps profit extraction
- Append-only ledger — Cannot edit trace history
- Bilateral consent — Agents can refuse any party
- Wise Authority deferral — Role-based, not person-based
- Published Covenant — Public accountability document
Multi-region active/active with zero single point of failure. Runs on 228 MB RAM baseline — deploys from Raspberry Pi to cloud clusters. Designed to be deleted: transitional architecture until migration to Veilid.
| Component | Purpose | Status |
|---|---|---|
| CIRISCore | Production deployment automation (Terraform/Ansible) | Private (operational security) |
All open source CIRIS repositories use AGPL-3.0 (network copyleft). Contributions welcome via pull requests.
For specialized agents (Medical, Legal, Financial): eric@ciris.ai
Where you can find CIRIS in person, plus recorded talks — see events/ for the full list.
Upcoming
- Jul 18–19, 2026 — Secure & Sovereign AI Workshop (Foresight Institute), Berlin — Eric presenting
Recent talks & recordings
- Apr 28, 2026 — CIRIS: An Open-Source Ethical AI Governance Framework, Agentic Engineering Chicago — recording
- Feb 9, 2026 — Building AI with a Conscience, IEEE Madison Section
- 2025 — The Need for Urgency: Embedding Ethical Reasoning in AI Systems, CodeNinja Podcast
- Apr 17, 2025 — Exploring the CIRIS Covenant
CIRIS vendors its Reticulum mesh transport from Leviculum, a full Rust implementation of the Reticulum network stack by Lew Palm. Thanks to Lew for maintaining it and for merging our upstream patches.
Discord · Status · Documentation · Research
Safe by structure. Open by principle. Kind by design.
© 2025-2026 Eric Moore and CIRIS L3C