33 lines
1.6 KiB
Markdown
33 lines
1.6 KiB
Markdown
# 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)
|