tcyber925-del/EthioBio-AI-Assistant

AI-powered biology learning assistant for Ethiopian Grades 7-12. LangGraph orchestration, hybrid RAG (pgvector + BM25), multi-provider LLM (Ollama/OpenRouter/OpenAI/Anthropic), Telegram bot, Next.js dashboard, JWT auth, tiered rate limiting. # EthioBio AI Assistant AI-powered biology learning and teaching assistant for Ethiopian middle and high school education (Grades 7-12). Uses LangGraph orchestration (unified graph with 12+ nodes), hybrid RAG (Dense + BM25 + Cross-encoder reranker), pgvector, and dynamic multi-provider AI system (Ollama, OpenRouter, OpenAI, Anthropic, OpenAI-compatible). ## Features - **Biology Q&A** — Ask biology questions, get curriculum-aligned answers with explicit source citations - **Interactive Quiz** — Tap-to-answer quizzes with inline buttons, instant feedback, and score tracking - **RAG-Grounded Generation** — Quiz questions and answers strictly based on Ethiopian textbook content - **Lesson Planning** — Create structured lesson plans with objectives, activities, and assessments - **Student Progress Tracking** — Monitor performance, identify weak areas, trend detection - **Parent Summaries** — Weekly progress reports in English and Amharic - **Amharic Support** — Bilingual explanations and translations - **LangGraph Orchestration** — Unified graph: intent classification → planner/retrieve/skip → plan_executor → evidence_graph → sufficient_context → synthesis → tutor → hallucination → claim_verifier → safety → finalize/revise/reject - **Agentic RAG** — Query rewriting, multi-index parallel search, iterative retrieval, claim verification - **Telegram Bot** — Primary user interface with interactive menus, commands, inline keyboards, conversation flows - **Teacher Dashboard** — Next.js web dashboard (9 pages) for content review, approval workflow, monitoring - **Hybrid RAG** — Dense (pgvector) + Sparse (BM25) + Cross-encoder reranker for accurate retrieval - **Source Citations** — Every answer cites `(Grade X, Unit Y: Title, p. Z)` format - **Multi-Provider AI** — Ollama primary with OpenRouter/OpenAI/Anthropic fallback chain, circuit breakers per provider - **Model Auto-Detection** — Discovers all locally installed Ollama models automatically - **Model Selection UI** — Cho …