README.md

metadata

title: Health-Insurance-RAG
emoji: 🏥
colorFrom: indigo
colorTo: purple
sdk: docker
app_port: 7860
pinned: false

🏥 Health Insurance AI Copilot & RAG Pipeline

A high-fidelity AI copilot for answering structured and unstructured health insurance policy queries. Built with FastAPI, Streamlit, LangGraph, Mem0 agent memory, Docling layout-aware chunking, NetworkX Knowledge Graphs, and OpenAI GPT-4o.

Features

• Dynamic RAG Pipeline: Combines BM25 lexical search, dense vector embeddings, and Cross-Encoder reranking.
• Structured Knowledge Graph (Graph RAG): Maps relationships between insurance plans, drugs, conditions, and network providers for complex, multi-hop lookups.
• 🧠 Mem0 Session Memory: Agent remembers facts within a session (plan tier, drug preferences, prior auth history) for personalized, context-aware answers — resets cleanly on Space refresh.
• 5-Node LangGraph Orchestrator: memory_search → classify_intent → retrieve → synthesize → memory_add
• High-Fidelity Developer Console: Interactive UI to inspect and visualize live agent orchestration node workflows.
• Unified Sidecar Container: FastAPI backend and Streamlit frontend served on a single port (7860).

Deployment on Hugging Face Spaces

1. Push this repo to your HF Space (Docker SDK, port 7860)
2. Go to Settings → Variables and Secrets and add:
   • OPENAI_API_KEY → your OpenAI key
   • GOOGLE_API_KEY → your Google key (optional)
3. The Space will build automatically — Mem0 runs in-memory, no extra setup needed.

API Endpoints

Method	Path	Description
POST	/chat	Send a query, get answer + memory facts used
GET	/memory/{session_id}	Inspect what Mem0 remembers for a session
DELETE	/memory/{session_id}	Clear session memory (keep chat history)
DELETE	/session/{session_id}	Clear full session including memory
GET	/health	Health check
GET	/dev-console	Live developer console