README.md

metadata

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