ciris-edge

Reticulum-native federation transport for the CIRIS stack. Replaces the Python edge across CIRISLens (FastAPI), CIRISAgent (httpx), CIRISRegistry (HTTPS) with a single Rust crate that does signed message in/out, verify-via-persist, and typed handler dispatch.

Status: v0.2.0 — Phase 1 substrate live. Verify pipeline (hybrid Ed25519 + ML-DSA-65 via persist's directory lookup), durable outbound queue + dispatcher, typed handler dispatch, HTTP transport, the CC 0.7 two-tier wire vocabulary (Tier-1 constitutional bodies + Tier-2 opaque app RPC — send::<OpaqueRequest> / OpaqueResponse / OpaqueEvent, WIRE_VOCABULARY_HASH build-gate pinned), and a sovereign-mode convenience constructor (EdgeBuilder::from_keyring_seed_dir) for Reticulum-style adoption with no persist Engine in-process. PyO3 surface (Edge class registration + init_edge_runtime) lands in v0.3.x; reticulum

  • multi-medium transports follow per Phase 3 of the FSD.

Read in this order

  1. MISSION.md — the WHY. Mission Driven Development alignment to CIRIS Accord Meta-Goal M-1; per-module mission statements; anti-patterns that violate the mission; failure modes.

  2. FSD/CIRIS_EDGE.md — the WHAT. Architecture spec, three-phase delivery plan, crate shape, public API surface, verify-via-persist contract, wire-format envelope, test categories.

  3. FSD/OPEN_QUESTIONS.md — the HOW. Thirteen design forks needing owner input before Phase 1 starts. Each question states the choice, the trade-off, and a lens-side default; resolutions land at the bottom in CLOSED.

TL;DR

The CIRIS architecture has three peers (agent, lens, registry) each maintaining their own network edge. Three parallel HTTP shims, three retry policies, three cert-management stories. The Proof-of-Benefit Federation FSD (~/CIRISAgent/FSD/PROOF_OF_BENEFIT_FEDERATION.md §3.2) names Reticulum-rs as the transport that closes the federation loop: addressing IS identity, multi-medium reach, fork-survivable Rust.

ciris-edge is the crate that operationalizes that proposal. Each peer becomes:

host application code
    │ registers handlers
    ▼
ciris-edge       ←── Reticulum link sessions (TCP / LoRa / serial / I²P)
    │ verify via persist
    ▼
ciris-persist    ←── steward identity, federation_keys, trace storage

One shape, many peers. Library, not sidecar. Verify happens at the wire, before any handler sees a byte. Key seeds never cross the FFI boundary. HTTP fallback ships in Phase 1 so cloud deployments can participate today; Reticulum is canonical and Phase 3 productionizes LoRa + serial + I²P for the deployments that need M-1 most.

Phases

Phase Outcome
1 (immediate) Crate skeleton; HTTP transport + Reticulum behind a feature flag; Ed25519 verify via persist; typed handler dispatch; lens cuts over from FastAPI to embedded edge runner
2 Agent + registry adopt edge; HTTPS becomes per-peer fallback
3 LoRa, packet-radio, serial transports productionized; off-grid CIRIS deployments tractable

Sister repos

  • CIRISAgent — agent reasoning loop; emits signed traces. Wire-format spec lives at FSD/TRACE_WIRE_FORMAT.md.
  • CIRISPersist — substrate. Owns the federation keys directory, steward identity, canonical-bytes canonicalization, trace storage. Edge calls into persist for sign + verify.
  • CIRISLens — analytical observatory. First peer to adopt edge in Phase 1 (cuts over from FastAPI ingest).
  • CIRISRegistry — identity / build / license / revocation directory. Adopts edge in Phase 2.
  • CIRISVerify — cryptographic primitives library. Edge depends transitively via persist.

License

AGPL-3.0, matching the rest of the CIRIS federation stack. License- locked mission preservation per MISSION.md §6.

Project links

Data verified by PyPI on Jul 15, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (15.0.0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for emoore from gravatar.com emoore

Credits

Author: CIRIS AI

GitHub Statistics

Data verified by PyPI on Jul 15, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

GNU Affero General Public License v3 or later (AGPLv3+) (AGPL-3.0-or-later)

Requires

Python >=3.10

Classifiers

Report project as malware

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_edge-13.1.1-cp310-abi3-win_amd64.whl (9.7 MB view details)

Uploaded CPython 3.10+Windows x86-64

ciris_edge-13.1.1-cp310-abi3-manylinux_2_39_x86_64.whl (17.1 MB view details)

Uploaded CPython 3.10+manylinux: glibc 2.39+ x86-64

ciris_edge-13.1.1-cp310-abi3-manylinux_2_39_aarch64.whl (15.9 MB view details)

Uploaded CPython 3.10+manylinux: glibc 2.39+ ARM64

ciris_edge-13.1.1-cp310-abi3-macosx_11_0_arm64.whl (15.9 MB view details)

Uploaded CPython 3.10+macOS 11.0+ ARM64

File details

Details for the file ciris_edge-13.1.1-cp310-abi3-win_amd64.whl.

File metadata

  • Download URL: ciris_edge-13.1.1-cp310-abi3-win_amd64.whl
  • Upload date:
  • Size: 9.7 MB
  • Tags: CPython 3.10+, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for ciris_edge-13.1.1-cp310-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 7dbae18c697aff87fabc497195dfb0c4e0965be8c4d89a395421eb53baff295a
MD5 b12fe3b386d9fff1fa781d5eaa83b913
BLAKE2b-256 b96e2c3542d781985b1178b298716b3087099a161bd7074658a6359b8880c453

See more details on using hashes here.

Provenance

The following attestation bundles were made for ciris_edge-13.1.1-cp310-abi3-win_amd64.whl:

Publisher: ci.yml on CIRISAI/CIRISEdge

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file ciris_edge-13.1.1-cp310-abi3-manylinux_2_39_x86_64.whl.

File metadata

File hashes

Hashes for ciris_edge-13.1.1-cp310-abi3-manylinux_2_39_x86_64.whl
Algorithm Hash digest
SHA256 9ee3147f515824d89ee67093969d3ce9ba38832356fe40d3e0dbd56d79c3bff4
MD5 9bc23b9810d914d12be41660f33fdc4a
BLAKE2b-256 855fbe47218fe5fd172c29ded1358ecb314f7ff8cb88671b8a6da9e33608836b

See more details on using hashes here.

Provenance

The following attestation bundles were made for ciris_edge-13.1.1-cp310-abi3-manylinux_2_39_x86_64.whl:

Publisher: ci.yml on CIRISAI/CIRISEdge

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file ciris_edge-13.1.1-cp310-abi3-manylinux_2_39_aarch64.whl.

File metadata

File hashes

Hashes for ciris_edge-13.1.1-cp310-abi3-manylinux_2_39_aarch64.whl
Algorithm Hash digest
SHA256 7b4401f53ccb46874d1c069172782fbfa6f9a826b1ab9ecb89ce2ee40c1cd093
MD5 bc4f5a31c1439bf99b8e4c945457922a
BLAKE2b-256 e3e2f1f921264d74d1291b7e6d3ecbab773e66ce56f1012c7d525d7adafc173c

See more details on using hashes here.

Provenance

The following attestation bundles were made for ciris_edge-13.1.1-cp310-abi3-manylinux_2_39_aarch64.whl:

Publisher: ci.yml on CIRISAI/CIRISEdge

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file ciris_edge-13.1.1-cp310-abi3-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for ciris_edge-13.1.1-cp310-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 70423d48c7e3b7a4add6cbdde89f43a96df50aef3a446fec30a3e0656daccbc3
MD5 b398825fef9dc2722387909f93d10e25
BLAKE2b-256 24c2892020d1ebc3d546786beaa9f89a61e5e4f8515585e97ace1dbc8ec11290

See more details on using hashes here.

Provenance

The following attestation bundles were made for ciris_edge-13.1.1-cp310-abi3-macosx_11_0_arm64.whl:

Publisher: ci.yml on CIRISAI/CIRISEdge

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

15.0.0

1 file

14.4.0

4 files

14.3.0

4 files

14.2.4

4 files

14.2.3

4 files

14.2.1

4 files

14.2.0

4 files

14.1.0

4 files

14.0.0

4 files

13.15.1

4 files

13.15.0

4 files

13.14.0

4 files

13.12.0

4 files

13.10.0

4 files

13.9.0

4 files

13.8.0

4 files

13.7.0

4 files

13.6.1

4 files

13.5.1

4 files

13.5.0

4 files

13.4.0

4 files

13.3.1

4 files

13.3.0

4 files

13.2.0

4 files

13.1.2

4 files

This release

13.1.1 This release

4 files

13.1.0

4 files

13.0.9

4 files

13.0.8

4 files

13.0.7

4 files

13.0.6

4 files

13.0.5

4 files

13.0.4

4 files

13.0.3

4 files

13.0.2

4 files

13.0.1

4 files

13.0.0

4 files

12.0.0

4 files

11.1.2

4 files

11.1.1

4 files

11.1.0

4 files

11.0.0

4 files

10.1.2

4 files

10.1.1

4 files

10.1.0

4 files

10.0.2

4 files

10.0.1

4 files

10.0.0

4 files

9.10.1

4 files

9.10.0

4 files

9.9.0

4 files

9.8.0

4 files

9.7.0

4 files

9.6.1

4 files

9.6.0

4 files

9.5.0

4 files

9.4.1

4 files

9.4.0

4 files

9.3.0

4 files

9.2.0

4 files

9.1.7

4 files

9.1.6

4 files

9.1.5

4 files

9.1.4

4 files

9.1.3

4 files

9.1.2

4 files

9.1.1

4 files

9.1.0

4 files

9.0.0

4 files

8.8.0

4 files

8.7.2

4 files

8.7.1

4 files

8.7.0

4 files

8.6.2

4 files

8.6.1

4 files

8.6.0

4 files

8.5.1

4 files

8.5.0

4 files

8.4.2

4 files

8.4.0

4 files

8.3.0

4 files

8.2.0

4 files

8.1.0

4 files

8.0.0

4 files

7.4.4

4 files

7.4.3

4 files

7.4.2

4 files

7.4.1

4 files

7.4.0

4 files

7.3.2

4 files

7.3.1

4 files

7.3.0

4 files

7.2.1

4 files

7.2.0

4 files

7.1.0

4 files

7.0.13

4 files

7.0.12

4 files

7.0.11

4 files

7.0.10

4 files

7.0.8

4 files

7.0.7

4 files

7.0.6

4 files

7.0.5

4 files

7.0.4

4 files

7.0.3

4 files

7.0.2

4 files

6.4.0

4 files

6.3.3

4 files

6.3.2

4 files

6.3.1

4 files

6.3.0

4 files

6.2.3

4 files

6.2.1

4 files

6.2.0

4 files

6.1.0

4 files

6.0.0

4 files

5.2.0

4 files

5.1.0

4 files

5.0.1

4 files

5.0.0

4 files

4.6.4

4 files

4.6.3

4 files

4.5.1

4 files

4.5.0

4 files

4.4.0

4 files

4.3.1

4 files

4.3.0

4 files

4.2.1

4 files

4.2.0

4 files

4.1.2

4 files

4.1.1

4 files

4.1.0

4 files

4.0.2

4 files

3.8.0

4 files

3.7.1

4 files

3.7.0

4 files

3.6.0

4 files

3.5.1

4 files

3.5.0

4 files

3.4.0

4 files

3.3.0

4 files

3.2.0

4 files

3.1.0

4 files

3.0.1

4 files

2.4.0

4 files

2.3.1

4 files

2.3.0

4 files

2.2.2

4 files

2.2.1

4 files

2.2.0

4 files

2.1.2

4 files

2.1.1

4 files

2.1.0

3 files

2.0.2

3 files

2.0.1

3 files

2.0.0

3 files

1.7.0

3 files

1.6.3

3 files

1.6.2

3 files

1.6.1

3 files

1.6.0

3 files

1.5.3

3 files

1.5.2

3 files

1.5.0

3 files

1.4.1

3 files

1.3.2

3 files

1.3.1

3 files

1.3.0

3 files

1.2.1

3 files

1.2.0

3 files

1.1.12

3 files

1.1.11

3 files

1.1.10

3 files

1.1.6

3 files

1.1.5

3 files

1.1.4

3 files

1.1.3

3 files

1.0.1

3 files

1.0.0

3 files

0.20.1

3 files

0.20.0

3 files

0.19.7

3 files

0.19.6

3 files

0.19.5

3 files

0.19.4

3 files

0.19.0

3 files

0.18.1

3 files

0.18.0

3 files

0.17.1

3 files

0.17.0

3 files

0.16.1

3 files

0.16.0

3 files

0.15.1

3 files

0.15.0

3 files

0.14.2

3 files

0.13.1

3 files

0.13.0

3 files

0.12.0

3 files

0.11.1

3 files

0.11.0

3 files

0.10.1

3 files

0.9.1

3 files

0.9.0

3 files

0.8.1

3 files

0.7.1

3 files

0.5.1

3 files

0.4.0

3 files

0.3.1

3 files

0.2.8

3 files

0.2.7

3 files

0.2.5

3 files

0.2.4

3 files

0.2.3

3 files

0.2.2

3 files

0.2.1

3 files

0.1.4

3 files

0.1.3

3 files

0.1.2

3 files

0.1.1

3 files

0.1.0

3 files

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