Spaces:
Sleeping
Sleeping
| title: AnatomyBot - MBBS Anatomy Tutor | |
| hackathon: https://huggingface.co/MCP-1st-Birthday | |
| emoji: 🩺 | |
| colorFrom: blue | |
| colorTo: purple | |
| sdk: gradio | |
| sdk_version: 6.0.0 | |
| app_file: app.py | |
| pinned: false | |
| license: mit | |
| short_description: AnatomyBot - Interactive AI-powered MBBS anatomy tutor. | |
| tags: | |
| - building-mcp-track-enterprise | |
| - building-mcp-track-customer | |
| - building-mcp-track-creative | |
| - mcp-in-action-track-creative | |
| - mcp-in-action-track-consumer | |
| # 🩺 AnatomyBot – MBBS Anatomy Tutor | |
| Welcome to our submission for the **Hugging Face MCP 1st Birthday Hackathon**! | |
| This project showcases **an intelligent multi-agent educational system** powered by **Gradio**, designed to revolutionize how medical students learn anatomy through **visuals, voice interaction, and active recall**. | |
| **Link to demo:** [https://huggingface.co/spaces/gladguy/SimpleProject](https://huggingface.co/spaces/gladguy/SimpleProject) | |
| **YouTube Video:** [https://www.youtube.com/watch?v=5L5suQMTd5I](https://www.youtube.com/watch?v=5L5suQMTd5I) | |
| --- | |
| ## 📝 What I want to showcase | |
| I want to showcase an intelligent, interactive educational platform designed specifically for MBBS (medical) students. The goal is to bridge the gap between static textbooks and active learning by providing: | |
| - **Visual & Contextual Learning**: Instantly fetching relevant anatomical diagrams alongside AI-generated educational summaries. | |
| - **Active Recall & Simulation**: A "VIVA Mode" that simulates an oral anatomy exam with a strict but fair AI professor, complete with voice interaction. | |
| - **Resource Augmentation**: A "Book Mode" that allows students to upload their own textbooks and get AI-powered analysis and quiz questions for specific pages. | |
| --- | |
| ## 🛠️ What I've built so far | |
| I have built a fully functional **Gradio** web application that integrates multiple powerful AI services: | |
| ### 1. Smart Query Engine | |
| * Uses **Hyperbolic AI (Llama 3.3 70B)** to validate if questions are strictly anatomy-related. | |
| * Fetches high-quality diagrams using **SERPAPI (Google Images)**, filtering out non-diagrammatic results. | |
| * Generates structured, emoji-rich educational content (Location, Features, Clinical Significance). | |
| ### 2. VIVA Training Mode | |
| * Simulates a real oral exam environment. | |
| * Generates progressive questions (from basic relations to clinical scenarios). | |
| * **Voice Interaction**: Uses **ElevenLabs** to vocalize questions, making the experience immersive. | |
| * **AI Evaluation**: Grades student answers (Distinction, Pass, Borderline, Fail) and provides detailed feedback with reference answers. | |
| ### 3. Book Learning Mode | |
| * Allows PDF textbook uploads. | |
| * Extracts and displays specific pages. | |
| * Analyzes page content to generate summaries, clinical points, and self-test questions. | |
| --- | |
| ## 💻 Tech Stack | |
| * **Frontend/UI**: Gradio (Python) | |
| * **LLM Intelligence**: Hyperbolic AI API (Meta Llama 3.3 70B Instruct) | |
| * **Image Search**: SERPAPI (Google Images Engine) | |
| * **Voice Synthesis**: ElevenLabs API (Text-to-Speech) | |
| * **Image/PDF Processing**: Pillow, PyPDF2, pdf2image | |
| * **Environment**: Python, Hugging Face Spaces | |
| --- | |
| ## 🔗 Quick Links | |
| - 🏆 **Hackathon:** [MCP 1st Birthday Hackathon](https://huggingface.co/MCP-1st-Birthday) | |
| - 📺 **YouTube Demo:** [Watch Video](https://www.youtube.com/watch?v=5L5suQMTd5I) | |
| - 🚀 **Live Demo:** [Try AnatomyBot](https://huggingface.co/spaces/gladguy/SimpleProject) | |
| - 💼 **LinkedIn Post:** [View Post](https://www.linkedin.com/posts/gladguy_learn-anatomy-with-ai-activity-7400990572884168705-14Ln/) | |
| --- | |
| ## 🛠️ Installation & Setup | |
| ### Prerequisites | |
| - Python 3.8 or higher | |
| - API Keys for SERPAPI, Hyperbolic, and ElevenLabs. | |
| ### Steps | |
| 1. Clone the repository: | |
| ```bash | |
| git clone https://huggingface.co/spaces/gladguy/SimpleProject | |
| cd SimpleProject | |
| ``` | |
| 2. Install dependencies: | |
| ```bash | |
| pip install -r requirements.txt | |
| ``` | |
| 3. Set up your `.env` file: | |
| ```bash | |
| SERPAPI_KEY=your_key | |
| HYPERBOLIC_API_KEY=your_key | |
| ELEVENLABS_API_KEY=your_key | |
| ``` | |
| 4. Run the app: | |
| ```bash | |
| python app.py or uv run app.py | |
| ``` | |
| --- | |
| ## 🧑💻 Authors | |
| - **Waheed** – *Lead Developer & AI Architect* | |
| - **HF Username** : gladguy | |
| - **Profile :** https://huggingface.co/spaces/gladguy | |
| --- | |
| ## 📝 License | |
| This project is licensed under the MIT License. |