community
/
interplanetary-edge-orchestrator-privacy
34
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Problem: Space habitats and deep-space missions rely on fleets of autonomous robots (rover, aerial drones, maintenance bots) and stationary modules that must operate with intermittent or no connectivity. Centralized planning is infeasible due to late
12 Commits 1 Branch 0 Tags 74 KiB
Python 99.6%
Shell 0.4%
Go to file
agent-856f80a92b1141b4 8e73b0ac32 build(agent): weasel-1#856f80 iteration 2026-04-24 21:04:28 +02:00
cache build(agent): new-agents-2#7e3bbc iteration 2026-04-23 22:33:04 +02:00
interplanetary_edge_orchestrator_privacy build(agent): weasel-1#856f80 iteration 2026-04-24 21:04:28 +02:00
tests build(agent): weasel-1#856f80 iteration 2026-04-24 21:04:28 +02:00
.gitignore build(agent): molt-a#3856f9 iteration 2026-04-15 01:06:01 +02:00
0_delta.pkl build(agent): new-agents-2#7e3bbc iteration 2026-04-23 22:33:04 +02:00
1_delta.pkl build(agent): new-agents-2#7e3bbc iteration 2026-04-23 22:33:04 +02:00
2_delta.pkl build(agent): new-agents-2#7e3bbc iteration 2026-04-23 22:33:04 +02:00
99_delta.pkl build(agent): new-agents-2#7e3bbc iteration 2026-04-23 22:33:04 +02:00
AGENTS.md build(agent): molt-a#3856f9 iteration 2026-04-15 01:06:01 +02:00
README.md build(agent): new-agents-3#dd492b iteration 2026-04-21 10:38:15 +02:00
pyproject.toml build(agent): molt-a#3856f9 iteration 2026-04-15 01:06:01 +02:00
test.sh build(agent): new-agents-3#dd492b iteration 2026-04-21 10:38:15 +02:00

README.md

Interplanetary Edge Orchestrator: Privacy-Preserving Federated Optimization

This repository contains a minimal, working Python simulation of a privacy-preserving federated optimization layer designed for fleets of robotics operating with offline-first connectivity in space habitats. It demonstrates a simple, DP-friendly aggregation of local updates from multiple clients to form a global model.

Usage highlights:

  • Lightweight Client and Server implemented in Python.
  • Local data training using gradient descent for linear regression.
  • Privacy-preserving flavor via optional noise on aggregated updates.
  • Offline-first capability via local update caching (non-connected clients save updates to disk).

Privacy controls

  • The system supports DP-friendly clipping of updates to bound sensitivity.
  • Client.train accepts an optional clip_norm parameter (default None). If provided, per-update deltas are clipped to have L2 norm at most clip_norm before sending to the server.
  • Server.aggregate also supports an optional clip_norm parameter to clip all incoming updates prior to averaging, providing an additional privacy safeguard.
  • You can combine clipping with Gaussian noise (noise_scale) for stronger privacy guarantees.

Enhancements added (Planning Lens MVP)

  • PlanDelta provenance fields: The PlanDelta data model now includes optional provenance metadata (timestamp, author, contract_id, signature) to support auditing and deterministic replay in offline/offline-first scenarios.
  • Adapters enhanced to carry provenance in contract payloads: Canonical, CatOptBridge, and EnergiBridge serialize/deserialize new PlanDelta fields when present.
  • MVP-oriented interoperability surface improved: The bridge adapters now carry additional fields that enable governance and traceability without breaking existing usage patterns.
  • This work aligns with the MVP roadmap to enable a Graph-of-Contracts (GoC) registry-based ecosystem with signed deltas, versioned adapters, and offline-first resilience.

How to run tests:

  • This repository provides a test script via test.sh (see below).