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.9-py3-none-win_amd64.whl (72.8 MB view details)

Uploaded Python 3Windows x86-64

ciris_agent-2.9.9-py3-none-manylinux2014_x86_64.whl (74.5 MB view details)

Uploaded Python 3

ciris_agent-2.9.9-py3-none-macosx_11_0_arm64.whl (79.7 MB view details)

Uploaded Python 3macOS 11.0+ ARM64

ciris_agent-2.9.9-py3-none-any.whl (11.2 MB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: ciris_agent-2.9.9-py3-none-win_amd64.whl
  • Upload date:
  • Size: 72.8 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.9-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 3cdf35129600dc121270bba261baa2ccdb7de6f3583fc0c44d235d3429b0954c
MD5 a187832fbcf9aff090ec4ae9e4a679ef
BLAKE2b-256 1ee8fe4c1b5b396f64b0b80d3488b960b1d76725388af7d6262568599b203715

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for ciris_agent-2.9.9-py3-none-manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 69ff9b7210c4d9c2862545b6d9381428f62c886a83e3cbb8d3858f94b10d947b
MD5 9b20d76b46fd97fec358a31847da5dbc
BLAKE2b-256 5fd32fad554b23947635b58e761e8ef7fc1b49945cd3733fc4ea659fbfc09361

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for ciris_agent-2.9.9-py3-none-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 c8c22a466921fffd6aab68fbaac76e47096da3f38b656c7282e42f5ead512509
MD5 f92791f7796fef949c42f8b0ef41c79c
BLAKE2b-256 fcf7ebf64a105dba1d30ec4ec68cd8735b7884bf3106d37dfd60f5c86d5e79e7

See more details on using hashes here.

File details

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

File metadata

  • Download URL: ciris_agent-2.9.9-py3-none-any.whl
  • Upload date:
  • Size: 11.2 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.9-py3-none-any.whl
Algorithm Hash digest
SHA256 e6750a35c6f63d53df11079ea710e86a2b09e7b0c946c7b7a577c735fb94654c
MD5 4a9081ddf3a616fb308d2af05ea0efcc
BLAKE2b-256 8169976b962e282e49b1248e805e2409bb19e19f4b07abb9a50676e67499c4a1

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