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 11, 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 11, 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-9.9.0-cp310-abi3-win_amd64.whl (9.5 MB view details)

Uploaded CPython 3.10+Windows x86-64

ciris_edge-9.9.0-cp310-abi3-manylinux_2_39_x86_64.whl (16.6 MB view details)

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

ciris_edge-9.9.0-cp310-abi3-manylinux_2_39_aarch64.whl (15.4 MB view details)

Uploaded CPython 3.10+manylinux: glibc 2.39+ ARM64

ciris_edge-9.9.0-cp310-abi3-macosx_11_0_arm64.whl (15.4 MB view details)

Uploaded CPython 3.10+macOS 11.0+ ARM64

File details

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

File metadata

  • Download URL: ciris_edge-9.9.0-cp310-abi3-win_amd64.whl
  • Upload date:
  • Size: 9.5 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-9.9.0-cp310-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 ea74fb47502d5136b6f41383b805140fde0d9a57b547b48a21d9d7e91b6cf1af
MD5 4a8b86f6f49becbf89846473837445b0
BLAKE2b-256 8b80e2d64dd869c83d7b2c6a422d98c4a934eb2820492c21ae6d544472a72a2d

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for ciris_edge-9.9.0-cp310-abi3-manylinux_2_39_x86_64.whl
Algorithm Hash digest
SHA256 686b7ac43bfdb931c9fa741042d8517f9dac8a2ed5d6a9bbd13d9ac821163f06
MD5 ad7fef252cc8fe6cd35a1d98b4ad45ce
BLAKE2b-256 275623ca33abcaffcd64ea263756c25b97f30132dd154d9b9697a1f6f2c3263c

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for ciris_edge-9.9.0-cp310-abi3-manylinux_2_39_aarch64.whl
Algorithm Hash digest
SHA256 b4dceaa7fc958a71bf056ecbd5479e616b8f29bc2761544262adf2bf8131fe07
MD5 7ab779cc221cec0682de78e10e0ff561
BLAKE2b-256 d85f504200f344b077b53d0637d9387762ce28f02117afb9ee756f3127fa0cd6

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for ciris_edge-9.9.0-cp310-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 adc3a908462fb6bf0f6fbc5f372b5ff67e4b0ca4933dadea69e3dc8a81e7dee1
MD5 d195d31c627462cab6f51e3fe70afba4
BLAKE2b-256 27c166b9f4fc20643bfdd029b7061464477c193889087f5c554c303ba123cbef

See more details on using hashes here.

Provenance

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

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

This release

9.9.0 This release

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