thealekhya/IDP_Ghana

Sankofa Health AI is a full-stack healthcare analytics platform built with FastAPI and Next.js for exploring healthcare facility data in Ghana. It integrates LLM-powered chat, semantic search, SQLite analysis, anomaly detection, and React Leaflet mapping to identify service gaps and support data-driven healthcare planning. # Sankofa Health AI **Sankofa** is a word from the Akan people of Ghana. It is commonly expressed as the idea of "go back and fetch it": learning from the past, recovering what is valuable, and using that knowledge to build a wiser future. The name fits this project because Sankofa Health AI looks back at healthcare facility data, service records, regional coverage, and suspicious claims to help communities and planners make better decisions for the future of healthcare access in Ghana. Sankofa Health AI is a full-stack healthcare intelligence platform for exploring healthcare facility coverage, service gaps, and suspicious facility claims in Ghana. It combines an AI chat assistant, healthcare data analysis, vector search, interactive maps, and anomaly detection in one web application. The project is designed for healthcare planning and decision support. Users can ask natural-language questions, inspect facility data, view hospitals on a map, analyze regional healthcare coverage, and identify inconsistencies in facility capabilities or specialty claims. ## Features - AI-powered healthcare chat assistant - Natural-language querying over Ghana healthcare facility data - Structured SQL-style analysis through a local SQLite database - RAG-based semantic search using LanceDB and sentence-transformers - Regional healthcare gap analysis - Medical consistency and anomaly detection - Interactive map of healthcare facilities - Facility markers with details such as name, contact information, status, and specialties - Support for Gemini and OpenAI LLM providers - FastAPI backend with a Next.js frontend - Clerk authentication support in the frontend ## Tech Stack ### Backend - Python - FastAPI - Uvicorn - LangGraph - LangChain - Gemini API through `langchain-google-genai` - OpenAI API through `langchain-openai` - LanceDB - Sentence Transformers - SQLite - Pandas - NumPy - PyArrow - Pydantic - python-dotenv ### Frontend - Next.js - React - TypeScript - Tailwind CSS - Cl …