MITPython / FastAPI
Red Humanitaria de Datos
A federated index so Venezuela's aid apps can share data through one common API.
It brings into one search the records of missing people, supply centers, hospitals, and resources that today live in separate apps. Each app can query the network and also contribute its normalized data.
- Stars
- 8
- Forks
- 5
- Language
- Python / FastAPI
- License
- MIT
THE PROBLEM
In an emergency many aid apps appear and each one builds its own index. The same person ends up scattered across sources and nobody sees the full picture.
Who it's for
Teams that run humanitarian aid apps, technical volunteers, and organizations that need to search several sources at once.
WHAT IT DOES
- Unified full-text search (FTS5 and BM25) by name, ID number, record type, or city.
- 22 built-in connectors; a new source is a single file in app/connectors/builtin/.
- Ingestion from partner apps with their own key, and writes closed by default if a key is missing.
- A same-person view across sources, with manual linking and unlinking by an admin.
- Federation between nodes with an incremental cursor-based feed.
- A public form to propose a source without touching code, held for review.
How it's built
- Connectors Each source exposes a CONNECTOR; the scheduler syncs them into the index.
- API FastAPI serves search, detail, ingestion, entities, peers, and proposals, documented in OpenAPI.
- Index Normalized records are stored with FTS5 search; the database lives only on each node and is never versioned.
- Federation Nodes register as peers and feed each other through the ?since= feed.
- Frontend A web search, a map, an entity page, sources, and a contribute page.
Stack
FastAPIPythonOpenAPIJavaScriptDocker
Why we built it
It aims to stop aid apps from duplicating the same index and to let the community carry it forward. It shows how Taveras Solutions designs many-source integrations while protecting sensitive data.
Getting started
python3 -m venv .venv && source .venv/bin/activate
python -m pip install -e ".[dev]"
cp .env.example .env # HOSPITALES_API_KEY, INGEST_API_KEY and ADMIN_API_KEY
fastapi dev app/main.py # docs at http://127.0.0.1:8000/docs
Need something like this built for you?
We use these same tools in our client projects.
Other open source projects
- SaaS starter django-saas-boilerplate A Django 6 SaaS starter: email login, Stripe subscriptions, a dashboard, CSP, and 67 tests. Ready to deploy.
- AI invoicing InvoiceFlow AI invoicing for the Dominican Republic: OCR, DGII tax alerts (ITBIS, dates, 606 data), invoices over WhatsApp, and 606 exports.
- macOS app ModelNap A menu bar app that puts idle local Ollama models to sleep and gives your Mac its memory back. Signed and notarized.