Skip to main content

CIRIS: Ethical AI Agent with Consensual Evolution Protocol

Project description

License Status DeepWiki CIRIS Architecture Coherence Ratchet Accord

CIRIS

A safer, more ethical AI assistant — one you can actually check.

Download on the App Store    Get it on Google Play

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 ... | bash runs 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.

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

ciris_agent-2.9.10-py3-none-win_amd64.whl (72.9 MB view details)

Uploaded Python 3Windows x86-64

ciris_agent-2.9.10-py3-none-manylinux2014_x86_64.whl (74.6 MB view details)

Uploaded Python 3

ciris_agent-2.9.10-py3-none-macosx_11_0_arm64.whl (79.8 MB view details)

Uploaded Python 3macOS 11.0+ ARM64

ciris_agent-2.9.10-py3-none-any.whl (11.3 MB view details)

Uploaded Python 3

File details

Details for the file ciris_agent-2.9.10-py3-none-win_amd64.whl.

File metadata

  • Download URL: ciris_agent-2.9.10-py3-none-win_amd64.whl
  • Upload date:
  • Size: 72.9 MB
  • Tags: Python 3, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.12.13

File hashes

Hashes for ciris_agent-2.9.10-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 a552deb6b08d91c9d62e3786585855496b25126dc35d6306a759aa01da3297ea
MD5 13fd2a67a3b8a5cf48b32c38e2cec9d7
BLAKE2b-256 d0dffc7ecb4c82837183ae5c4f902a32897ea942632105fd31b689cb7499ef0a

See more details on using hashes here.

File details

Details for the file ciris_agent-2.9.10-py3-none-manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for ciris_agent-2.9.10-py3-none-manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 ffac55c851a38b1b874669f9b26394bea9a8b2ede5fef2cdb8469ae99bbe17f5
MD5 f587180c989483795135efc8da27a76e
BLAKE2b-256 cd2a30fce84a08e87e97c40a58a4e92d6e7538c3e328d8064b5dc29af7950a54

See more details on using hashes here.

File details

Details for the file ciris_agent-2.9.10-py3-none-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for ciris_agent-2.9.10-py3-none-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 0c88a1428815ff0915c86b59d4bd19394443842194416d21ed285b90887a1428
MD5 2560e9b0a6a9b0393a17f2f387d4cb08
BLAKE2b-256 ead6fa226521b71edab21c15a38e9b4e11e9712dfdb9445c0ccffff10a97e61e

See more details on using hashes here.

File details

Details for the file ciris_agent-2.9.10-py3-none-any.whl.

File metadata

  • Download URL: ciris_agent-2.9.10-py3-none-any.whl
  • Upload date:
  • Size: 11.3 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.12.13

File hashes

Hashes for ciris_agent-2.9.10-py3-none-any.whl
Algorithm Hash digest
SHA256 c42f32acca4d0022b1d26508aa941b7fdff1e47aedcc0c6e19cb7f6e7dc50e22
MD5 018a893a2c4c9ee73dc3523312d9c04d
BLAKE2b-256 7ac1acf2d3860909923e14959d83d8ebd8b1a73ee53aa92b01d51f425fcaae84

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page