Bayurzx/ravencry-web
Domain:
peace and securitynatural language processingRecord type:
software
Creator:
Bay
Host:
A Nigeria-native, multi-channel, AI-powered anti-kidnapping and missing persons rapid alert platform.
# RAVENCRY
**Real-time AI for Vigilance, Event Notification, and Crisis Response Yielding.**
A Nigeria-native, multi-channel, AI-powered anti-kidnapping and missing persons rapid alert platform. Citizens report via WhatsApp, USSD (`*384*72836#`), Telegram, SMS, or PWA. Qwen AI triages in Hausa, Yoruba, Igbo, Pidgin, and English. Crucix sweeps OSINT sources. FLASH alerts broadcast via SMS, Telegram, and push to subscribers within 160km.
> **Hackathon:** H01 Devpost (Vercel + AWS) + Qwen Cloud Hackathon · June 2026
>
> **PWA:** ravencry-web.vercel.app
---
## Architecture
**Full context:** diag_architect.md — service inventory, data
flows, endpoints, DNS routing, architectural decisions, and judge-facing diagram
checklist.
**Alert lifecycle + data model ERD:** docs/alert-lifecycle.svg ·
docs/data-model.svg
**Feature map:** features.md — hackathon → scale roadmap.
**Build log:** hackathon_context.md — key decisions,
debugging discoveries, and architectural rationale.
---
## Quick Start — Docker
```bash
# 1. Clone + env
git clone github.com && cd ravencry
cp .env.example .env
# Fill in .env — see "Secrets" section below
# 2. Start local Postgres (dev DB)
docker compose -f docker-compose.yml -f docker-compose.dev.yml up -d dev-postgres
# Run migrations + seed: see steps3_db_docker.md (3 min)
# 3. Start the stack
docker compose -f docker-compose.yml -f docker-compose.dev.yml up -d
docker compose ps # all services healthy
```
**Full dev DB guide:** steps3_db_docker.md
## Quick Start — Node (no Docker)
```bash
# Each service runs independently:
cd services/api && npm install && npm run dev # :3003
cd services/llm && npm install && npm run dev # :3002
cd services/crucix && npm install && npm run dev # :3001
cd services/telegram && npm install && npm run dev # :3005
cd services/sms && npm install && npm run dev # :3006
cd services/ussd && npm install && npm run dev # :3007
```
Requires PostgreSQL 16 …