ciris-persist
Unified Rust persistence for the CIRIS federation — signed events, time-series, runtime state.
Decision gist · record as of 2026-08-14
Yes, with conditions. Install if you are building a CIRIS federation node and need unified, constitution-aligned storage for signed events, audit logs, secrets, and telemetry. The active maintenance, zero known vulnerabilities, and Postgres/SQLite parity make it solid for federation use. Avoid if you require proprietary licensing (AGPLv3+ is restrictive) or horizontal sharding (library-only, not a service). The medium install friction (compiled Rust wheel) is typical for performance-critical storage layers.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10+; ciris-verify v5.10.0 must be installed; Postgres or SQLite backend required.
- Medium install friction due to compiled Rust extension (PyO3 wheel); actively maintained with recent release (15 days ago).
- Requires Python 3.10+.
License · maintenance · safety
AGPL-3.0-or-later (agpl) — AGPLv3+ license requires derivative works and network-accessible modifications to be open-sourced; suitable for open federation infrastructure but restrictive for proprietary deployments.
last release 2026-07-30 (15 days) · last repo commit 2026-08-14 · 1 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 110,290 downloads/mo, #12,472 on PyPI
Alternatives
Verify before relying
import ciris_persist as cp
engine = cp.Engine(dsn="sqlite://./agent.db", signing_key_id="agent-ed25519")
engine.register_consumer("my-adapter", ["cirisgraph"])
summary = engine.receive_and_persist(request_body_bytes)- Whether the PyO3 wheel covers all target platforms beyond macOS ARM64 (Linux, Windows availability unclear).
- Performance characteristics under high-concurrency workloads beyond the published benchmark suite.
- Compatibility guarantees between ciris-persist v22.0.1 and ciris-verify v5.10.0 across future releases.
What it is and what it does
CIRISPersist is a Rust-backed storage layer for CIRIS federation nodes, exposing a unified Python API that abstracts away the choice between Postgres and SQLite backends. It manages multiple stateful substrates—signed reasoning traces, hash-chained audit logs, memory graphs, time-series telemetry, encrypted secrets, federation consensus state, fountain-coded content, and holonomic forever-memory tiers—all through one versioned interface. The package is designed as an in-process library (not a daemon), allowing a CIRIS agent or lens node to link it directly and avoid hand-rolling ~11 separate storage services.
The implementation enforces post-quantum cryptography (hybrid Ed25519 + ML-DSA-65) at federation tier, routes all signing and verification through ciris-verify to avoid crypto re-rolls, and aligns with the CIRIS Constitution 0.1.5 substrate clauses. Secrets are encrypted at rest using AES-256-GCM with hardware-backed master keys where available. The audit log uses RFC 6962 Merkle trees; the forever-memory substrate implements CEG §19 / §19.7 with signed manifests and authenticated partial reads. Both backends achieve 100% parity on every method, including observability queries and lens-derived schemas.
Use it for
- Store signed reasoning traces and LLM-call logs for a CIRIS agent with cryptographic proof of event ordering.
- Maintain a hash-chained, per-tenant audit log compliant with RFC 6962 Merkle tree standards.
- Manage federated secrets with AES-256-GCM encryption and TPM/Keystore-backed master keys in a single API.
- Run a sovereign CIRIS node on resource-constrained hardware (Pi, iOS) using SQLite without second-class performance.
- Implement post-quantum-signed federation consensus state and holonomic memory tiers per CEG §19.
- Ingest and route divergence detection through quorum-merge logic without embedding a separate graph database.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, with conditions.
Install if you are building a CIRIS federation node and need unified, constitution-aligned storage for signed events, audit logs, secrets, and telemetry. The active maintenance, zero known vulnerabilities, and Postgres/SQLite parity make it solid for federation use. Avoid if you require proprietary licensing (AGPLv3+ is restrictive) or horizontal sharding (library-only, not a service). The medium install friction (compiled Rust wheel) is typical for performance-critical storage layers.
Install
ciris-persist on PyPI
Before you install
Medium install friction due to compiled Rust extension (PyO3 wheel); actively maintained with recent release (15 days ago). Requires Python 3.10+. Single runtime dependency on ciris-verify.
Requires Python 3.10+; ciris-verify v5.10.0 must be installed; Postgres or SQLite backend required.
License in practice
AGPLv3+ license requires derivative works and network-accessible modifications to be open-sourced; suitable for open federation infrastructure but restrictive for proprietary deployments.
Quickstart
import ciris_persist as cp
engine = cp.Engine(dsn="sqlite://./agent.db", signing_key_id="agent-ed25519")
engine.register_consumer("my-adapter", ["cirisgraph"])
summary = engine.receive_and_persist(request_body_bytes)Verify before relying
- Whether the PyO3 wheel covers all target platforms beyond macOS ARM64 (Linux, Windows availability unclear).
- Performance characteristics under high-concurrency workloads beyond the published benchmark suite.
- Compatibility guarantees between ciris-persist v22.0.1 and ciris-verify v5.10.0 across future releases.
Package facts
| License | AGPL-3.0-or-later agpl |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Medium. Platform-specific wheel |
| Runtime dependencies | 1 packageciris-verify |
| Maintenance | Actively maintained 15 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 110,290 / month, #12,472 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)Programming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: RustTopic :: DatabaseTopic :: System :: Logging |
Evidence: ciris_persist-22.0.1-cp310-abi3-macosx_11_0_arm64.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “CIRIS federation persistence layer”
- ciris-persistCIRISPersist provides unified, versioned storage for CIRIS federation…
- ciris-edgeA Rust-based transport and replication layer for the CIRIS Epistemic…
- ciris-verifyProvides Python bindings to verify hardware-rooted software licenses…
Give your agent the search over MCP, or paste the wish link into any chat.
More Database packages
psycopg2-binary is a PostgreSQL database adapter for Python that implements the DB API 2.0 specification, enabling Python applications to connect to and query PostgreSQL databases with thread-safe concurrent operations.
Python client library for connecting to and executing commands against Redis key-value stores, supporting both synchronous and asynchronous operations.
Install it if your application needs to interact with Redis; the only prerequisite is a running Redis server instance.
YDB Python SDK is the official client library for connecting to and querying YDB databases from Python applications.
Install it if you need to connect Python applications to YDB databases.
Connects Python applications to Snowflake data warehouses using the DB API 2.0 specification, enabling SQL queries, data transfers, and warehouse operations.
sqlparse tokenizes SQL text into a tree of statements, clauses, and expressions, and provides functions to split scripts, format queries, and inspect parsed tokens without validating dialect or syntax.
Install it if you need to manipulate, format, or analyze SQL text programmatically.
Provides base adapter protocols and shared functionality that database adapters use to integrate with dbt-core, handling connections, dialect translation, relation caching, and core interface management.
See also ciris-edge · ciris-server · ciris-verify · agent-framework-foundry-hosting · llama-index-storage-docstore-postgres · pycadf · rpds-py · langgraph-checkpoint-postgres · django-crum · agent-governance-toolkit-core