MITPython / FastAPI
Red Humanitaria de Datos
Un índice federado para que las apps de ayuda de Venezuela compartan datos por una API común.
Reúne en un solo buscador los registros de personas desaparecidas, centros de acopio, hospitales y recursos que hoy viven en apps separadas. Cada app puede consultar la red y también aportar sus datos normalizados.
- Estrellas
- 8
- Forks
- 5
- Lenguaje
- Python / FastAPI
- Licencia
- MIT
EL PROBLEMA
En una emergencia aparecen muchas apps de ayuda y cada una arma su propio índice. La misma persona queda repartida entre fuentes y nadie ve el cuadro completo.
Para quién
Equipos que mantienen apps de ayuda humanitaria, voluntarios técnicos y organizaciones que necesitan buscar en varias fuentes a la vez.
QUÉ HACE
- Búsqueda unificada con texto completo (FTS5 y BM25), por nombre, cédula, tipo de registro o ciudad.
- 22 conectores incluidos; una fuente nueva es un solo archivo en app/connectors/builtin/.
- Ingesta desde apps aliadas con llave propia, y escrituras cerradas por defecto si falta una llave.
- Vista de la misma persona entre fuentes, con enlace y desenlace manual por un administrador.
- Federación entre nodos con un feed incremental por cursor.
- Formulario público para proponer una fuente sin tocar código, que queda pendiente de revisión.
Cómo está armado
- Conectores Cada fuente expone un CONNECTOR; el scheduler los sincroniza hacia el índice.
- API FastAPI sirve búsqueda, detalle, ingesta, entidades, peers y propuestas, documentado en OpenAPI.
- Índice Los registros normalizados se guardan con búsqueda FTS5; la base vive solo en cada nodo y no se versiona.
- Federación Los nodos se registran como peers y se nutren unos de otros con el feed ?since=.
- Frontend Buscador web, mapa, ficha de entidad, fuentes y página para contribuir.
Stack
FastAPIPythonOpenAPIJavaScriptDocker
Por qué lo hicimos
Busca que las apps de ayuda dejen de duplicar el mismo índice y que la comunidad lo continúe. Muestra cómo Taveras Solutions diseña integraciones entre muchas fuentes cuidando datos sensibles.
Cómo empezar
python3 -m venv .venv && source .venv/bin/activate
python -m pip install -e ".[dev]"
cp .env.example .env # HOSPITALES_API_KEY, INGEST_API_KEY y ADMIN_API_KEY
fastapi dev app/main.py # docs en http://127.0.0.1:8000/docs
Necesitas algo así a la medida?
Usamos estas mismas herramientas en los proyectos de nuestros clientes.
Otros proyectos open source
- Starter de SaaS django-saas-boilerplate Starter de SaaS con Django 6: login por correo, suscripciones con Stripe, dashboard, CSP y 67 pruebas. Listo para desplegar.
- Facturas con IA InvoiceFlow Facturas con IA para República Dominicana: OCR, alertas fiscales de la DGII (ITBIS, fechas, datos del 606), facturas por WhatsApp y exportación del 606.
- App para macOS ModelNap App de barra de menú que duerme los modelos locales de Ollama cuando no los usas y le devuelve la memoria a tu Mac. Firmada y notarizada.