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 16, 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 16, 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.2-cp310-abi3-win_amd64.whl (9.7 MB view details)

Uploaded CPython 3.10+Windows x86-64

ciris_edge-13.1.2-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.2-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.2-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.2-cp310-abi3-win_amd64.whl.

File metadata

  • Download URL: ciris_edge-13.1.2-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.2-cp310-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 8f1e024fe48804a9ec013f61f37c170e610d1236d695a8d455bf947826f85cee
MD5 73e728c6c93f8bff407475409df8a1e1
BLAKE2b-256 3c2b60beebbbd52f89a0a5210acf6d0bc9cbed8c14900f63f851a8de68aa5f73

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for ciris_edge-13.1.2-cp310-abi3-manylinux_2_39_x86_64.whl
Algorithm Hash digest
SHA256 06cf75cf28ee6356562d619a26b3aa200ba2e196ae8f9c19238a1a79d91b720a
MD5 bc4d1f54984b823c78b2b427cbf399ee
BLAKE2b-256 ebdfbf9687fd698ca924bf1707a1bb5b3967c2fa073ddeb4e085576fb3d21081

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for ciris_edge-13.1.2-cp310-abi3-manylinux_2_39_aarch64.whl
Algorithm Hash digest
SHA256 1d66a97fce9c539bb9c29120a81f08ade571972c8a4f8bae39ee51a5192a7422
MD5 458d48d407fff1c8e8a3265311924acb
BLAKE2b-256 b18372baaee90a62adfa769a2a403643f01fc8b095534d63c3b433b078250f65

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for ciris_edge-13.1.2-cp310-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 3784cdb3f928d7b506719c278dabb56c69956c0ac8df214ea82845cf8cfc91d4
MD5 a62f887cd295be84150a5da69f8d5857
BLAKE2b-256 cc85d9c24becef76a354ca797255dbbc26b0fbc55d2695f48cee1280b6fe4be5

See more details on using hashes here.

Provenance

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

This release

13.1.2 This release

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