jrcity/vid

The Pan-African Network Identity System. Built with Nokia Network-as-Code (NaC) CAMARA APIs # VID (Virtual ID) — Sovereign Network Identity for Africa **VID (Virtual ID)** is a decentralized, privacy-preserving identity system that leverages the **GSMA CAMARA APIs** (via Nokia Network-as-Code) and **Random Forest ML** to provide every African with a verifiable digital identity—no plastic cards required. --- ## 📺 Project Demo **Watch the Full System Walkthrough** --- ## 🚀 The Problem - **Identity Gap**: 500M+ Africans lack foundational ID. - **Privacy Leakage**: Current KYC processes require sharing PII (Names/Phones) with third parties. - **Fraud**: SIM swapping and identity theft are unchecked. - **Exclusion**: Rural feature phone users are locked out of digital services. ## 💡 The Solution VID transforms your **SIM card** into a trust anchor. By analyzing 5 core network signals, we calculate a **Trust Score** and generate a **Virtual ID** (e.g., Virtual NIN in Nigeria, Virtual Huduma in Kenya). ### Key Features: - **Zero-PII Storage**: We store SHA-256 hashes, never your name or phone number. - **Multi-SIM Bonding**: Trust scoring across multiple mobile networks. - **Agentic Monitor**: Autonomous fraud detection and auto-revocation. - **Universal Access**: Parity between premium Web App and USSD (`*384*57911#`). - **Pan-African**: Native support for 54+ countries and 6 local languages (Hausa, Swahili, Zulu, etc.). --- ## 🛠️ Architecture VID is built on a modern, high-performance stack: - **Backend**: FastAPI (Python 3.11+) - **Trust Engine**: Scikit-Learn (Random Forest Classifier) - **Networking**: Nokia NaC SDK (CAMARA APIs) - **Frontend**: React 18, TypeScript, Tailwind CSS - **USSD**: Africa's Talking Gateway - **Monitoring**: Autonomous Agentic Workers (Asyncio) For a deep dive into the engineering, see **docs/ARCHITECTURE.md**. --- ## 📂 Documentation - **Case Study** — Problem, Solution, and Impact. - **Feature Catalogue** — Detailed breakdown of all capabilities. - **User Guide** — Step-by-step instructions with screenshots. - **Pitc …