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 19, 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 19, 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.5.1-cp310-abi3-win_amd64.whl (9.8 MB view details)

Uploaded CPython 3.10+Windows x86-64

ciris_edge-13.5.1-cp310-abi3-manylinux_2_39_x86_64.whl (17.7 MB view details)

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

ciris_edge-13.5.1-cp310-abi3-manylinux_2_39_aarch64.whl (16.3 MB view details)

Uploaded CPython 3.10+manylinux: glibc 2.39+ ARM64

ciris_edge-13.5.1-cp310-abi3-macosx_11_0_arm64.whl (16.3 MB view details)

Uploaded CPython 3.10+macOS 11.0+ ARM64

File details

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

File metadata

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

File hashes

Hashes for ciris_edge-13.5.1-cp310-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 43feabbc6b40db2728cc715fdfdb791c38cb4f2668a6b70dad86ab96ad6172a1
MD5 e07707f5d30f0e60d0b69b0c6f1b0ef3
BLAKE2b-256 895f103dea21c6cba32f2ee493e43e94fe0ea7a20190d250a8dd7d91f4fbb6ab

See more details on using hashes here.

Provenance

The following attestation bundles were made for ciris_edge-13.5.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.5.1-cp310-abi3-manylinux_2_39_x86_64.whl.

File metadata

File hashes

Hashes for ciris_edge-13.5.1-cp310-abi3-manylinux_2_39_x86_64.whl
Algorithm Hash digest
SHA256 c4ed2f3115b8be1e671c3d0af7db4c4d17c91901dd7d86918258411672ea2053
MD5 899e2a91117d2670a6f8a6f68451be7a
BLAKE2b-256 0998ecc763b813674e3d4676dfe26746388e2b21ad5e96d9322ee21c15e8869c

See more details on using hashes here.

Provenance

The following attestation bundles were made for ciris_edge-13.5.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.5.1-cp310-abi3-manylinux_2_39_aarch64.whl.

File metadata

File hashes

Hashes for ciris_edge-13.5.1-cp310-abi3-manylinux_2_39_aarch64.whl
Algorithm Hash digest
SHA256 8fbc984cfaeb2a70cd41f9c2433ac125744848a87a7cc440a1cdf8c6c721a4d6
MD5 573928650fa5ded4c911157763da3992
BLAKE2b-256 e92e6465f67aae3bd695d29b75e7538450fe4aa71cb13920dbc3e62389373e30

See more details on using hashes here.

Provenance

The following attestation bundles were made for ciris_edge-13.5.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.5.1-cp310-abi3-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for ciris_edge-13.5.1-cp310-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 c8f205d25eb5aeaae029cfcde17ff2d1eed4e67ab1d631571263b6d82fe468ab
MD5 42dca9bee368e548b660997b032b56d7
BLAKE2b-256 97cd3106ca1f04b39d4e90088f70ea33810fea90608bef709f38ad749229e4eb

See more details on using hashes here.

Provenance

The following attestation bundles were made for ciris_edge-13.5.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

This release

13.5.1 This release

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

13.1.1

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