An open-source collaborative registry of people located after the Venezuela earthquake, featuring search, per-person pages, a public API, a contribution form, and a moderation panel with OCR.

Stars

31

7-day growth

No data

Forks

30

Open issues

5

License

MIT

Last updated

2026-07-02

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It provides a transparent, community-driven tool for disaster response, with built-in moderation, OCR integration for handwritten lists, and a public API for third-party integrations.

Who it is for

  • Developers building similar disaster-response systems
  • Humanitarian organizations coordinating earthquake relief
  • Venezuelan authorities and hospitals managing located persons
  • Citizens seeking information about located relatives

Use cases

  • Searching for a located person by name, ID, or observation
  • Contributing new records of located individuals through a moderated form
  • Moderating and approving submitted data via an admin panel with OCR support
  • Integrating the public API to power external apps or dashboards

Strengths

  • Fully open-source (MIT license) with a clear contribution workflow
  • Includes a moderation panel with OCR (OpenAI Vision) to transcribe handwritten lists
  • Provides a public read-only API with CORS enabled for GET routes
  • Comes with seed data and Docker setup for easy local development

Considerations

  • Only designed for located persons, not for reporting missing people
  • Requires MongoDB and Node.js (22+) setup, which may be complex for non-technical users
  • OCR features depend on an OpenAI API key, incurring potential costs

README quick start

Localizados Venezuela

Registro open source y colaborativo de personas ya localizadas tras el sismo en Venezuela — en hospitales, recintos, direcciones y otros sitios.

Sitio: localizadosvenezuela.com

Este proyecto es solo para localizados. No sirve para reportar desaparecidos.
Para desaparecidos: desaparecidosterremotovenezuela.com

Qué hace

  • Búsqueda de personas localizadas por nombre, cédula u observación
  • Una página por persona (/localizados/{slug}) y por lugar (/lugares/{slug})
  • API pública de lectura para integraciones
  • Formulario para contribuir localizados o fotos de listados (quedan en cola pending hasta moderación)
  • Panel de moderación (/admin) para aprobar contribuciones, OCR de imágenes, CRUD de personas y acciones masivas
  • Botones para compartir en WhatsApp, Telegram, X, etc.

Requisitos

  • Node.js 22+
  • MongoDB 6+ (local o remoto)
  • npm

Empezar en 5 minutos

git clone https://github.com/ggangix/localizados-venezuela.git
cd localizados-venezuela
npm install
cp .env.example .env.local

Usa .env.local. Tanto Next.js (npm run dev) como los scripts de seed (vía tsx --env-file=.env.local) lo leen. Está en .gitignore, así que tus credenciales no se suben.

Levanta MongoDB. Dos opciones comunes:

# A) Instalado localmente, sin autenticación
mongod

# B) En Docker con usuario/clave (lo más habitual)
docker run -d --name mongo -p 27017:27017 \
  -e MONGO_INITDB_ROOT_USERNAME=root \
  -e MONGO_INITDB_ROOT_PASSWORD=123456 \
  mongo:7

Si usas la opción B (Docker con autenticación), tu MONGODB_URI en .env.local debe llevar las credenciales y ?authSource=admin (el usuario root vive en la base admin):

MONGODB_URI=mongodb://root:123456@localhost:27017/localizados_venezuela?authSource=admin

Carga datos de prueba e inicia el servidor:

npm run seed:sample
npm run dev

Abre http://localhost:3000.

Desarrollo con Docker

Si prefieres no instalar Node.js ni MongoDB localmente, puedes levantar todo el entorno con Docker.

Requisitos: Docker Desktop (o Docker Engine + Compose).

cp .env.example .env.local   # si aún no lo has hecho
docker co

Description

Registro

Related repositories

Similar projects matched by category, topics, and programming language.

TanStack
Featured
TanStack GitHub avatar

router

TanStack Router is a type-safe, data-driven React router with built-in caching, prefetching, and nested layouts, while TanStack Start extends it into a full-stack SSR framework.

Web DevelopmentFrontend Frameworks
14,861
vercel-labs
Featured
vercel-labs GitHub avatar

scriptc

scriptc compiles ordinary TypeScript into small, fast native executables without needing Node.js, V8, or any JavaScript runtime in the binary.

Developer ToolsCode Quality & Build
1,985
Jakubantalik
Featured
Jakubantalik GitHub avatar

thinking-orbs

A React component library that renders six hand-tuned animated thought orb loading indicators on a plain 2D canvas, with two purpose-tuned sizes and automatic theme detection for AI and agent UIs.

AI & Machine LearningAI Agents
1,191