---
id: ciris-server
version: "0.5.172"
license: AGPL-3.0-or-later
license_treatment: agpl
maintenance: active
---

# ciris-server — The fabric node — the federation's headless cohabitation runtime (registry + lens [+ node] over one shared substrate), as the abi3 wheel CIRISAgent consumes. agent = fabric node + brain.

License: agpl · Maintenance: active · Downloads: 85.4K/mo

## What it is and what it does

ciris-server is a headless federation node that composes three Rust libraries—ciris-persist (corpus and admission control), ciris-edge (transport and replication), and ciris-verify (post-quantum cryptography)—into a single runnable service. It is shipped both as a standalone binary and as a PyO3 abi3 wheel that agents can embed. Unlike its component libraries, which make cryptographic and admission decisions in isolation, the server runs control loops that reconcile a live node to a signed claim graph (CEG), exposes every decision to an operator, and manages a decentralized mesh without privileged parties.

The node's defining constraint is that it does not reason, decide, or act on its own—it attests, stores, replicates, scores, and serves. Configuration is entirely claim-driven and signed; no environment variables are used. The architecture claims to solve the open problem of building a mesh that is simultaneously decentralized (no privileged relay), moderatable (graded consent ladders at every hop), and scalable (ALM tree with bounded per-node fan-out and logarithmic depth). Replication uses AEAD encryption such that relays cannot read the payloads they forward, and moderation is applied by authoring claims rather than by external policy.

Use it for:

- Run a federated node in a decentralized mesh where you control admission and consent topology without a central authority.
- Embed the node as a library in a CIRISAgent to provide the fabric infrastructure that agents depend on for attestation and replication.
- Build a moderatable P2P network where every hop is an operator-accountable node with its own consent edges and graded moderation ladder.
- Store and replicate signed claims across a network where relays cannot inspect or tamper with encrypted payloads in transit.
- Operate a node in a federation where configuration is entirely versioned as signed claims and can be updated hot without restart.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Embeds a Rust-based federation node that composes cryptographic attestation, replication, and verification into a Python-callable service for decentralized mesh networks.

Yes, but with conditions. Install if you are building or testing a decentralized federation using the CIRIS ecosystem and can tolerate early-stage software (first release 2026-08-08, 2 repository stars). The AGPL-3.0-or-later license is suitable for open infrastructure but incompatible with proprietary deployments. No known security vulnerabilities, active maintenance, and zero runtime dependencies reduce friction. However, scalability claims are modeled rather than proven, and the package's maturity is unproven—treat as experimental for production use.

## Install

pip install ciris-server
uv add ciris-server
poetry add ciris-server

## Installing ciris-server

Before you install: Medium install friction due to compiled wheels across multiple platforms (Android, macOS, Linux, Windows). Active maintenance with recent releases, but very new package (first release 2026-08-08) with minimal adoption signal—only 2 repository stars warrant caution in production use.

License in practice: AGPL-3.0-or-later license requires that any modifications or derivative works distributed to others must be released under the same license and include source code. Suitable for open infrastructure but incompatible with proprietary deployments or closed-source integrations.

Quickstart:

pip install ciris-server

import ciris_server
node = ciris_server.Node(home='/path/to/node', key_id='your-identity')
node.start()

Requires Python >=3.10; compiled wheels are platform-specific (Android, macOS, Linux, Windows). Node identity and configuration must be provided at boot via signed CEG claims, not environment variables.

Verify before relying:

- Actual scalability at claimed participant counts; topology is modeled but not yet tested at scale
- Performance characteristics and throughput under realistic federation load
- Stability and breaking-change risk given the package's very recent release history
- Interoperability guarantees with other CIRIS ecosystem components (ciris-persist, ciris-edge, ciris-verify)

## Package facts

- License: AGPL-3.0-or-later (agpl)
- Python support: supports_current
- Install friction: medium
- Maintenance: active
- Downloads: 85.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

federated node mesh networking, decentralized attestation storage, post-quantum cryptography node, consent-based claim routing, distributed consensus fabric, replication and verification service, decentralized identity infrastructure, federated-mesh, post-quantum-crypto, claim-based-routing

[View on SkillFed](https://skillfed.io/packages/ciris-server) · [View on PyPI](https://pypi.org/project/ciris-server/)