CIRIS: Ethical AI Agent with Consensual Evolution Protocol
Project description
CIRIS replaces apps like ChatGPT and Grok everywhere you need AI. It's the same chat you already expect — but it shows its reasoning, escalates to a human when it's unsure, keeps your data private, works in 29 languages, and runs on your own device. Open source, free, no ads, no growth-at-all-costs pressure.
Desktop & self-host: pip install ciris-agent — see Run it yourself.
Sign in with Google for the free hosted CIRIS model, or bring your own key
(OpenAI, Anthropic, Groq, Together.ai, or a local model).
Why CIRIS
- It shows its work. Every answer passes ethical, common-sense, domain, and reasoning-fragility checks — and you can see why it said yes or no, not just the answer.
- It defers to you. When a decision is uncertain, CIRIS escalates to a designated human ("Wise Authority") instead of guessing.
- Private by design. Runs on your device. The hosted CIRIS proxy stores nothing — your prompts are not logged and never train a model.
- Speaks your language. The entire ethical-reasoning system — not just the buttons — operates in 29 languages.
- Auditable and open. AGPL-3.0, cryptographically signed decisions, a tamper-evident audit trail, and a public ethical framework anyone can review: the Accord.
Not a replacement for humans — a tool that knows its limits.
How it works
CIRIS wraps every AI response in a reasoning pipeline: multiple evaluation passes for ethics, common sense, domain knowledge, and reasoning fragility (it flags answers that lean on a single weak source). Uncertain calls defer to designated humans. Every decision is written to a hash-chained audit trail. Today CIRIS powers Discord community moderation in production at agents.ciris.ai; the architecture is built to scale to settings like education and healthcare.
The design is described in two papers — CIRIS Architecture and the Coherence Ratchet.
Run it yourself
pip install ciris-agent
ciris-agent # desktop app + local API server
ciris-agent --adapter discord # or run it as a Discord bot
Server install (agent + web UI) — download, optionally inspect, then run:
curl -fsSLO https://ciris.ai/install.sh
# (optional) read install.sh to see what it does, then:
bash install.sh
Security note: piping
curl ... | bashruns unreviewed code straight from the network. Downloading first lets you inspect the script before executing it.
For developers
Under the consumer app, CIRIS is a type-safe, auditable AI agent framework — 22 core services on a 6-bus message architecture, 200+ API endpoints, 4 GB RAM target, 10,000+ tests. Extend it with adapters, run it headless, or embed it.
- Documentation Hub — everything, organized
- Architecture · API Reference · Quick Start
- Contributing · Security · For AI assistants
Honest read
CIRIS is real and running in production, but young — version 2.x, under active development. It proves an AI is accountable, not that it is correct: the reasoning is made visible so you can judge it yourself. It does not give medical advice or substitute for professional care. It is not magic — it is an ordinary chat assistant, plus the accountability machinery that closed apps don't give you.
CIRIS — Core Identity, Integrity, Resilience, Incompleteness, and Signalling Gratitude Copyright © 2025 Eric Moore and CIRIS L3C · AGPL-3.0 · Release Notes · Issues
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distributions
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ciris_agent-2.9.6-py3-none-win_amd64.whl.
File metadata
- Download URL: ciris_agent-2.9.6-py3-none-win_amd64.whl
- Upload date:
- Size: 68.8 MB
- Tags: Python 3, Windows x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
856bd5c99e0b19c029740a93b984002f667553bfb226917b91a3b9854ca55ea1
|
|
| MD5 |
ec2d3d145dcc54e789b6bdb52abe53ed
|
|
| BLAKE2b-256 |
b43df759137445c51acd5a3ca9d9521180d6567b9bfb51905b0ee9524270ef95
|
File details
Details for the file ciris_agent-2.9.6-py3-none-manylinux2014_x86_64.whl.
File metadata
- Download URL: ciris_agent-2.9.6-py3-none-manylinux2014_x86_64.whl
- Upload date:
- Size: 70.5 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9ed956cf7273939a33dc8ac9a2210629864f2bb0d7c93852893cc52ac0039c46
|
|
| MD5 |
cc53a1fe70f5594e8d8ad99aaa0cd985
|
|
| BLAKE2b-256 |
36a453b34d47621a0638e4de6f0766b3fdaa87b4cac212988a520c29f29c11c5
|
File details
Details for the file ciris_agent-2.9.6-py3-none-macosx_11_0_arm64.whl.
File metadata
- Download URL: ciris_agent-2.9.6-py3-none-macosx_11_0_arm64.whl
- Upload date:
- Size: 75.7 MB
- Tags: Python 3, macOS 11.0+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
78bcf95e8bb87be90a3c9c1160ce98d6e8767096c1291ec104c74762a32fd817
|
|
| MD5 |
b85015763de1acbfd6bae6b48a867e8f
|
|
| BLAKE2b-256 |
0e406c0666a3a6909115f8780af8d9278be96e0a753a5a8e0a65ed7617358799
|
File details
Details for the file ciris_agent-2.9.6-py3-none-any.whl.
File metadata
- Download URL: ciris_agent-2.9.6-py3-none-any.whl
- Upload date:
- Size: 10.6 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e662de25e2f2b5264a6761e2f23f414f627ab1146d8e6ca13c3dc44e28819839
|
|
| MD5 |
e33ea74f68e521460a1e54b8b6b4ed71
|
|
| BLAKE2b-256 |
3a36846fa0e89c14c2165f648825b6c1fe09edfdba1032597f84e4ac61c4427e
|