README.md

metadata

title: Medical AI Assistant
emoji: 🩺
colorFrom: green
colorTo: blue
sdk: docker
pinned: false
license: mit
app_port: 7860
short_description: Multilingual medical consultation AI assistant

🩺 Medical AI Assistant

A multilingual medical consultation AI assistant optimized for Hugging Face Spaces.

✨ Features

• 🌍 Multilingual Support: English and French medical consultations
• 🧠 Medical Knowledge: AI-powered responses based on medical literature
• ⚡ Fast Processing: Optimized for quick responses
• 📚 Educational Focus: Provides educational medical information with proper disclaimers

🚀 Quick Start

1. Visit the API Documentation at /docs to explore all endpoints
2. Try the main endpoint: POST /medical/ask
3. Use demo questions from /medical/demo

📋 Example Usage

English Consultation

{
  "question": "What are the symptoms of malaria?",
  "language": "en"
}

French Consultation

{
  "question": "Quels sont les symptômes du paludisme?",
  "language": "fr"
}

Other Consultation

{
  "question": "Quels sont les symptômes du paludisme?",
  "language": "auto"
}

🔧 API Endpoints

• GET / - Welcome message and API info
• POST /medical/ask - Medical consultation endpoint
• GET /health - System health check
• GET /medical/demo - Sample demo questions
• GET /docs - Interactive API documentation
• GET /redoc - Alternative API documentation

⚕️ Medical Disclaimer

This AI assistant provides educational medical information only. Always consult qualified healthcare professionals for proper medical diagnosis and treatment.

🏗️ Technical Details

• Framework: FastAPI
• AI Models: Lightweight transformers optimized for Spaces
• Languages: Python 3.9+
• Deployment: Docker on Hugging Face Spaces

📞 Support

For technical issues or questions, please check the API documentation at /docs.

---

Optimized for Hugging Face Spaces deployment