Spaces:
Sleeping
Sleeping
| title: BioGPT Medical Assistant | |
| emoji: 🏥 | |
| colorFrom: blue | |
| colorTo: purple | |
| sdk: gradio | |
| sdk_version: 4.44.0 | |
| app_file: app.py | |
| pinned: false | |
| license: mit | |
| short_description: AI pediatric medical chatbot powered by BioGPT | |
| tags: | |
| - medical | |
| - healthcare | |
| - pediatric | |
| - biogpt | |
| - chatbot | |
| - medicine | |
| - health | |
| models: | |
| - microsoft/BioGPT-Large | |
| datasets: [] | |
| # 🏥 BioGPT Medical Assistant | |
| An AI-powered medical chatbot specialized in pediatric medicine, built with Microsoft's BioGPT model and deployed via Gradio. | |
| ## 🎯 Features | |
| - **Specialized Medical AI**: Powered by BioGPT-Large, trained on extensive medical literature | |
| - **Pediatric Focus**: Specialized knowledge in children's health and medicine | |
| - **Evidence-Based**: Responses based on medical research and clinical guidelines | |
| - **Interactive Chat**: User-friendly Gradio interface with medical-themed design | |
| - **Safety First**: Clear disclaimers and guidance on when to seek professional care | |
| ## 🩺 Capabilities | |
| ### Medical Topics Covered: | |
| - **Pediatric Symptoms**: Fever, cough, rash, digestive issues | |
| - **Treatment Guidance**: Evidence-based treatment information | |
| - **Emergency Signs**: When to seek immediate medical attention | |
| - **Prevention**: Vaccination schedules, disease prevention | |
| - **Development**: Growth and developmental milestones | |
| ### Key Features: | |
| - Real-time medical information retrieval | |
| - Context-aware responses using medical knowledge base | |
| - Conversational AI with natural language understanding | |
| - Memory-efficient deployment with model quantization | |
| - Comprehensive medical disclaimers and safety information | |
| ## 🚀 Technical Details | |
| - **Base Model**: Microsoft BioGPT-Large | |
| - **Framework**: Gradio for web interface | |
| - **Deployment**: Hugging Face Spaces | |
| - **Optimization**: 8-bit quantization for efficient GPU usage | |
| - **Embeddings**: Sentence transformers for context retrieval | |
| - **Device Support**: CUDA GPU with CPU fallback | |
| ## ⚠️ Important Medical Disclaimer | |
| **This AI assistant provides educational medical information only and is NOT a substitute for professional medical advice, diagnosis, or treatment.** | |
| ### Always Consult Healthcare Professionals For: | |
| - Medical diagnosis and treatment decisions | |
| - Prescription medications | |
| - Personalized medical advice | |
| - Emergency medical situations | |
| ### Emergency Situations - Call Emergency Services: | |
| - Difficulty breathing or choking | |
| - Severe allergic reactions | |
| - Unconsciousness | |
| - Severe injuries | |
| - Persistent high fever (>104°F/40°C) | |
| ## 🛠️ Installation & Setup | |
| ### For Local Development: | |
| 1. **Clone the repository**: | |
| ```bash | |
| git clone <your-repo-url> | |
| cd biogpt-medical-chatbot | |
| ``` | |
| 2. **Install dependencies**: | |
| ```bash | |
| pip install -r requirements.txt | |
| ``` | |
| 3. **Run the application**: | |
| ```bash | |
| python app.py | |
| ``` | |
| ### For Hugging Face Spaces Deployment: | |
| 1. Create a new Space on Hugging Face | |
| 2. Choose "Gradio" as the Space SDK | |
| 3. Upload the following files: | |
| - `app.py` | |
| - `requirements.txt` | |
| - `README.md` | |
| 4. The Space will automatically build and deploy | |
| ## 📁 File Structure | |
| ``` | |
| ├── app.py # Main Gradio application | |
| ├── requirements.txt # Python dependencies | |
| └── README.md # This file | |
| ``` | |
| ## 🔧 Configuration | |
| The chatbot automatically detects available hardware and configures accordingly: | |
| - **GPU Available**: Uses CUDA with 8-bit quantization | |
| - **CPU Only**: Falls back to CPU with appropriate settings | |
| - **Model Loading**: Attempts BioGPT-Large, falls back to smaller models if needed | |
| ## 💡 Usage Tips | |
| ### For Best Results: | |
| 1. **Be Specific**: Ask detailed questions about symptoms or conditions | |
| 2. **Include Context**: Mention age, duration of symptoms, etc. | |
| 3. **Medical Focus**: Focus on pediatric and general medical topics | |
| 4. **Clear Language**: Use clear, simple language in your questions | |
| ### Example Queries: | |
| - "What causes fever in children?" | |
| - "My 3-year-old has been coughing for 2 days, what should I do?" | |
| - "When should I be concerned about my baby's breathing?" | |
| - "What are the signs of dehydration in infants?" | |
| ## 🤝 Contributing | |
| Contributions are welcome! Please feel free to submit issues, feature requests, or pull requests. | |
| ## 📄 License | |
| This project is licensed under the MIT License - see the LICENSE file for details. | |
| ## 🙏 Acknowledgments | |
| - **Microsoft Research** for the BioGPT model | |
| - **Hugging Face** for model hosting and transformers library | |
| - **Gradio** for the web interface framework | |
| - **Medical Community** for evidence-based medical knowledge | |
| ## 📞 Support | |
| For technical issues or questions about deployment, please open an issue in this repository. | |
| **For medical emergencies, always contact emergency services or healthcare professionals immediately.** | |
| --- | |
| *Last updated: August 2025* |