Skip to main content

License Status DeepWiki Coherence Ratchet Constitution Constitution PDF

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 Constitution (the Accord folded into it; PDF).

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 the Coherence Ratchet paper.

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

Metadata

Release files for ciris-agent 2.18.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distributions (wheels)

Table of built distributions (wheels) for ciris-agent 2.18.0
File Actions
ciris_agent-2.18.0-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details for ciris_agent-2.18.0-py3-none-win_amd64.whl
ciris_agent-2.18.0-py3-none-manylinux2014_x86_64.whl Python 3 none Linux glibc 2.17+ x86-64 Details for ciris_agent-2.18.0-py3-none-manylinux2014_x86_64.whl
ciris_agent-2.18.0-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details for ciris_agent-2.18.0-py3-none-macosx_11_0_arm64.whl
ciris_agent-2.18.0-py3-none-any.whl Python 3 none any Details for ciris_agent-2.18.0-py3-none-any.whl

Total release size: 281.8 MB

Release files / ciris_agent-2.18.0-py3-none-win_amd64.whl

Download URL ciris_agent-2.18.0-py3-none-win_amd64.whl
Size 85.9 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
e0237b47d8249fbd7bd1e951973c4b63a82a07b632e2445c284f950dba94ca4b
BLAKE2b-256 checksum
How to use checksums
dca54345901d7df45a9c1ce13e109d4efdbc264c62ef39f1ef886135666bd4ee
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.15

Release files / ciris_agent-2.18.0-py3-none-manylinux2014_x86_64.whl

Download URL ciris_agent-2.18.0-py3-none-manylinux2014_x86_64.whl
Size 87.7 MB
Tags Linux glibc 2.17+ x86-64 Python 3
SHA-256 checksum
How to use checksums
0a1edb90bef2ad507d31fef60df410048d62c8312464733ffd5a3655ef72f7c0
BLAKE2b-256 checksum
How to use checksums
e439ee5b0ad117e925befed73641021328c359c47034d5c04c69de11da1602ef
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.15

Release files / ciris_agent-2.18.0-py3-none-macosx_11_0_arm64.whl

Download URL ciris_agent-2.18.0-py3-none-macosx_11_0_arm64.whl
Size 92.9 MB
Tags Python 3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
05d7e65f130e7071978843e1ad769b5a27b55437df12448fcda51465b98f8929
BLAKE2b-256 checksum
How to use checksums
80f49c29edb35daef99b2dad31ee2b83c3cd2767ccd76c257b455dda3adf9e5d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.15

Release files / ciris_agent-2.18.0-py3-none-any.whl

Download URL ciris_agent-2.18.0-py3-none-any.whl
Size 15.3 MB
Tags Python 3
SHA-256 checksum
How to use checksums
d628e3f068274d8c72e3b59e84cced9c0702177396359f5ff8667c18b74189d8
BLAKE2b-256 checksum
How to use checksums
ac465f55603ce877ef0c218aebbd4e0c230cb53c8014d3ce193d047e97e8dc6c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.15

Security for ciris-agent 2.18.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

2.18.0 This release

4 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page