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.

LayerPackageLang
SubstrateCIRISVerify — hardware-rooted license verificationRust
SubstrateCIRISPersist — signed events, time-series, runtime stateRust
SubstrateCIRISEdge — Reticulum-native federation transportRust
ServerCIRISServer — federation consensus, science layer (cohort routes, manifold scoring), and cryptographic trust backboneRust
AgentCIRISAgent — H3ERE runtime + Compose Multiplatform clientPython / Kotlin

Open Source Repositories

Core Agent Platform

RepositoryLangLoCDescription
CIRISAgentPython / Kotlin~640KCore agent runtime — H3ERE engine, 35+ adapters, 22-service microarchitecture, Compose Multiplatform mobile client
CIRISManagerPython/TS~55KAgent lifecycle orchestration, fleet management (Book VIII)
CIRISBenchPython~33KHE-300 ethics benchmark framework (ethicsengine.org)

Trust & Verification

RepositoryLangLoCDescription
CIRISRegistryRust~31KCryptographic trust backbone — agent identity, Ed25519, gRPC + HTTP
CIRISVerifyRust~88KHardware-rooted license verification — TPM, Secure Enclave, hybrid PQC

Services

RepositoryLangLoCDescription
CIRISLensPython/Rust~32KCovenant Compendium — public trace store driving Coherence Ratchet (Annex H)
CIRISBillingPython~31KCredit-based usage metering with Stripe integration
CIRISProxyPython~8KLLM routing with Zero Data Retention (Annex I, GDPR compliance)
CIRISNodePython/React~25KDeferral routing to Wise Authorities · admin.ethicsengine.org

User Interfaces

RepositoryDescription
CIRISPortalAdmin dashboard — agent registration, key management, audit viewer (~37K LoC, TS/React)
CIRISGUIWeb interface with real-time ethical reasoning display
CIRISGUI-StandaloneLocalhost deployment with static export
CIRISGUI-AndroidNative Android client
CIRISHomeHome Assistant integration for ethical home automation

Research & Tooling

RepositoryDescription
RATCHETCoherence & honesty testing framework
CIRISOssicleGPU entropy sensor — detect unauthorized compute
CIRISBridgeMulti-region deployment orchestration (transitional)
ciris-websiteDocumentation and website (ciris.ai)

Specialized Agents (Closed Source)

Professional agents requiring regulatory compliance and mandatory human oversight:

AgentDomainWhy Closed
CIRISMedicalPhysician-supervised healthcare AIRegulatory compliance, physician oversight mandates
CIRISLegalLegal compliance and reasoningAttorney oversight, privileged communications
CIRISFinancialFinancial services and fiduciaryFiduciary 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 SectionComponentWhat It Does
Seven RequirementsCIRISAgentRuntime enforcement of all seven
Annex H — CompendiumCIRISLensPublic trace repository driving Coherence Ratchet
Annex I — Zero RetentionCIRISProxyGDPR/CCPA compliance, no prompt logging
Book VIII — Dignified SunsetCIRISManagerGraceful lifecycle management with consent
Creator LedgerCIRISRegistryTrust provenance, stewardship tiers
Licensed AgentsCIRISVerifyHardware-rooted proof of professional licensing
HE-300 BenchmarkCIRISBenchStandardized 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.

LanguageLines
Python661,120
Rust459,775
TypeScript162,112
Kotlin119,754
Shell28,519
SQL18,253
Lean14,436
JavaScript11,628
Protobuf8,092
Swift7,147
HCL5,847
C1,843
Dockerfile1,507
Makefile928
Objective-C289
Java39
Total1,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

URLPurpose
ciris.aiDocumentation and website
portal.ciris.aiAdmin dashboard
ethicsengine.orgPUBLIC HE-300 ethical benchmark
admin.ethicsengine.orgLicensed agent administration
scout.ciris.aiPublic demo agent
ciris.ai/explore-a-traceInteractive trace viewer
ciris.ai/ciris-scoringCoherence metrics
ciris.ai/coherence-ratchetRatchet mechanism docs
ciris.ai/research-statusAcademic 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.

ComponentPurposeStatus
CIRISCoreProduction 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 CIRISAgentPublic

    Python 52 16

  2. CIRIS-Covenant.github.io CIRIS-Covenant.github.ioPublic

    MDX 5 3

  3. CIRISNode CIRISNodePublic

    Server for alignment and comms

    Python 5 6

  4. RATCHET RATCHETPublic

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

    Python 4

  5. CIRISBench CIRISBenchPublic

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

    Python 4 1

  6. CIRISGUI CIRISGUIPublic

    Agent GUI

    TypeScript 2

Repositories

Showing 10 of 50 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…