Skip to content
@CIRISAI

CIRISAI

CIRIS — Accord-Driven Ethical AI

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


How It Works

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.


Seven Requirements

Every CIRIS agent must implement all seven:

  1. Published Principles — Bound to public ethical framework
  2. Runtime Conscience (H3ERE) — Four checks before every action
  3. Human Deferral — Automatic escalation under uncertainty
  4. Cryptographic Audit — Ed25519-signed decision ledger
  5. Bilateral Consent — Symmetric refusal rights
  6. Open Source (AGPL-3.0) — Code transparency for community agents
  7. Intuition (Corridor/IDMA) — Epistemic diversity monitoring

The Decentralized Agent — 5 Packages

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

Open Source Repositories

Core Agent Platform

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)

Trust & Verification

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

Services

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

User Interfaces

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

Research & Tooling

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)

Specialized Agents (Closed Source)

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.


Agent Types

  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 Implementation

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


Technology Stack

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.


Public Endpoints

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

Quick Start

pip install ciris-agent

Or:

curl -sSL https://ciris.ai/install.sh | bash

Structural Protections

CIRIS 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

Infrastructure

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)

Contributing

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


Events

Where you can find CIRIS in person, plus recorded talks — see events/ for the full list.

Upcoming

Recent talks & recordings


Acknowledgments

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.


Community

Discord · Status · Documentation · Research


Safe by structure. Open by principle. Kind by design.

© 2025-2026 Eric Moore and CIRIS L3C

Popular repositories Loading

  1. CIRISAgent CIRISAgent Public

    Python 41 15

  2. CIRIS-Covenant.github.io CIRIS-Covenant.github.io Public

    MDX 5 3

  3. CIRISNode CIRISNode Public

    Server for alignment and comms

    Python 4 6

  4. SageGUI SageGUI Public

    Web interface for managing GDPR data subject requests through the CIRISAgent multi-source DSAR orchestration system.

    TypeScript 2

  5. RATCHET RATCHET Public

    Reference Architecture for Testing Coherence and Honesty in Emergent Traces - Computational validation of the Coherence Ratchet framework

    Python 2

  6. CIRISBench CIRISBench Public

    CIRIS Benchmarking and Evaluation Infrastructure - HE-300 ethical benchmarks, EthicsEngine Enterprise, and CI/CD pipelines

    Python 2 1

Repositories

Showing 10 of 45 repositories

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Top languages

Loading…

Most used topics

Loading…