Upload README.md

README.md

@@ -0,0 +1,163 @@
+---
+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*