Skip to content
Taveras Solutions · Go to home
Book a diagnostic

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

  1. Connectors Each source exposes a CONNECTOR; the scheduler syncs them into the index.
  2. API FastAPI serves search, detail, ingestion, entities, peers, and proposals, documented in OpenAPI.
  3. Index Normalized records are stored with FTS5 search; the database lives only on each node and is never versioned.
  4. Federation Nodes register as peers and feed each other through the ?since= feed.
  5. 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.