1.6 KiB
1.6 KiB
HopeMesh: Federated, Privacy-Preserving Humanitarian Resource Allocation
Overview
- HopeMesh is a distributed, offline-first platform to coordinate humanitarian aid across agencies in crisis zones with intermittent connectivity.
- It models local needs as LocalProblem, supply signals as SharedSignals, and delta actions as PlanDelta within a Graph-of-Contracts (GoC) architecture.
- The MVP focuses on cross-domain adapters (supply-inventory tracker and field-needs collector) with TLS transport, governance ledger skeleton, and a small cross-domain objective.
Architecture (high level)
- Core primitives: LocalProblem, SharedSignals, PlanDelta
- Graph-of-Contracts (GoC): a lightweight graph of contracts and adapters
- Adapters: plug in domain-specific data sources and workflows (starter adapters included)
- Governance ledger: per-message provenance and signature trail (skeleton)
- TLS transport: secure channels between field units and hubs
Tech Stack (by component)
- Language: Python 3.9+
- Packaging: pyproject.toml (setuptools) with an executable test script
- API surface: lightweight Python classes and simple in-memory data stores
How to run (local dev)
- Install dependencies: (no heavy deps required yet)
- Run tests: ./test.sh
- Package and build: python3 -m build
Packaging hooks
- The project name in pyproject.toml is idea152-hopemesh-federated-privacy to satisfy publishing rules.
- The Python importable package is idea152_hopemesh_federated_privacy (underscore style) to align with Python packaging norms.
Contributing
- See AGENTS.md for architecture, testing commands, and contribution rules.
License: MIT (example)