README.md

---
title: Dental AI Assistant
emoji: 🏃
colorFrom: yellow
colorTo: indigo
sdk: gradio
sdk_version: 5.39.0
app_file: app.py
pinned: false
hardware: cpu-upgrade
suggested_hardware: t4-small
---

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference


🦷 Dental AI Assistant
An advanced dental consultation and medication extraction system powered by AI. This application provides dental advice, medication recommendations, and intelligent text analysis for medical documents.

🚀 Try it now: This Space is running on Hugging Face! No installation required.

✨ Features

🩺 Dental Consultation: Get AI-powered dental advice with detailed medication regimens
💊 Medication Extraction: Extract and highlight medications from medical text using NLP
🎨 Interactive Visualization: Visual representation of extracted medication entities
⚡ Quick Questions: Pre-built common dental questions for instant answers
⚙️ Customizable Settings: Adjust response length and creativity parameters
🚀 GPU/CPU Support: Automatic device detection and optimization
📱 Modern UI: Clean, responsive Gradio interface

🎯 Quick Start (Hugging Face Spaces)

Dental Consultation:

Click on the "💬 Dental Consultation" tab
Ask your dental question or select from quick questions
Get AI-powered advice with medication recommendations


Medication Extraction:

Switch to "💊 Medication Extraction" tab
Enter your Gemini API key (get it from Google AI Studio)
Paste medical text to extract medication information


🔑 Required API Key
For medication extraction functionality, you'll need a Gemini API Key:

Visit Google AI Studio
Sign in with your Google account
Click "Get API Key"
Create a new API key
Use it in the "Medication Extraction" tab


🎯 Usage Examples
Example 1: Dental Consultation
Question: "I have a severe toothache with swelling, provide 3-day medication"

Expected Response: Detailed medication regimen including:
- Antibiotics (dosage, frequency, duration)
- Pain relievers (mechanism of action)
- Anti-inflammatory medications
- Professional consultation disclaimer

Example 2: Medication Extraction
Input Text: "Patient prescribed 500mg Amoxicillin TID for 7 days and 400mg Ibuprofen QID PRN for pain"

Expected Output:
- Medication: Amoxicillin, Ibuprofen
- Dosage: 500mg, 400mg
- Frequency: TID, QID PRN
- Duration: 7 days, as needed

🚨 Important Disclaimers
⚠️ Medical Disclaimer: This AI assistant is for educational purposes only. Always consult with a qualified dentist or healthcare professional for medical advice, diagnosis, or treatment.
⚠️ Accuracy: While the AI strives for accuracy, medical information should always be verified with healthcare professionals.
⚠️ Emergency: For dental emergencies, contact your dentist or emergency services immediately.

🔧 Technical Details

Model Information

Model: yasserrmd/DentaInstruct-1.2B
Framework: Hugging Face Transformers
Device: Auto-detected (GPU/CPU)
Precision: Float16 (GPU) / Float32 (CPU)


Gemini API Errors

Verify API key is correct
Check API quota and billing
Ensure key has necessary permissions


📄 License
This project is licensed under the MIT License.
🙏 Acknowledgments

Model: yasserrmd/DentaInstruct-1.2B
Framework: Hugging Face Transformers
UI: Gradio
NLP: LangExtract
API: Google Gemini


Built with ❤️ for the dental community