Multi-Agent Healthcare Intelligence Platform for Ghana Virtue Foundation × Databricks × AI Tinkerers Hackathon — Bridging Medical Deserts
# 💊 MedBridge AI
> **Multi-Agent Healthcare Intelligence Platform for Ghana**
> Virtue Foundation × Databricks × AI Tinkerers Hackathon — *Bridging Medical Deserts*
MedBridge AI analyses **797 medical facilities and NGOs** across Ghana through **6 coordinated AI agents**. Users ask natural-language questions and receive structured answers, interactive maps, and actionable insights — powered by a LangGraph orchestration pipeline with self-correcting feedback loops, optional **quantum-optimised routing**, and a cyberpunk-styled React frontend.
---
## Quick Start
```bash
# Clone & install
git clone && cd MedBridgeAI
python -m venv .venv && .venv\Scripts\activate # source .venv/bin/activate on Linux/Mac
pip install -r requirements.txt
# Configure
cp .env.example .env # add GROQ_API_KEY, QDRANT_URL, QDRANT_API_KEY
# Run
uvicorn backend.api.main:app --host 0.0.0.0 --port 8000
cd frontend && npm install && npm run dev # →
localhost
```
---
## How It Works
```
User Question
│
▼
┌───────────┐ ┌────────┐ ┌────────────┐ ┌───────────┐ ┌──────────┐ ┌────────┐
│ Supervisor │───►│ Genie │ │ Vector │ │ Medical │ │Geospatial│ │Planning│
│ (Router) │ │Analyst │ │ Search │ │ Reasoning │ │Navigator │ │Strategy│
└───────────┘ └───┬────┘ └─────┬──────┘ └─────┬─────┘ └────┬─────┘ └───┬────┘
│ │ │ │ │
└────────────┴──────────────┴─────────────┴────────────┘
│
▼
┌──────────────┐ ┌───────────┐
│ Aggregator │────►│ Frontend │
│ + LLM Summary│ │ Results │
└──────┬───────┘ └───────────┘
│ retry if 0 results
└──────► (self-correction)
```
**Flow modes:** Sequential (e.g. Vector Search → Medical Reasoning) · Parallel (e.g. Genie + Geospatial) · Single agent
---
## The 6 Agents
### 1 · Supervisor — *The Router*
Classifies user intent and decides which agents to call.
- **Top-2-mean embedding pooling** — averages the 2 best similarities per intent (more robust than m …