README.md

metadata

title: Well Being Agent - Breast Cancer Support
emoji: 🏥
colorFrom: pink
colorTo: purple
sdk: docker
sdk_version: '3.0'
app_file: app.py
pinned: false

🏥 Well Being Agent - Breast Cancer Support

An AI-powered multilingual breast cancer support system providing evidence-based information and emotional support in English and Urdu.

🌟 Features

• 🤖 AI-Powered Responses - Evidence-based breast cancer information
• 🌐 Multilingual Support - English & Urdu language support
• 🎙️ Voice Input - Speech-to-text for convenient queries
• 💬 Text Chat - Traditional text-based interface
• ❤️ Emotional Support - Compassionate, hopeful responses
• 🏥 Medical Focus - Treatment, recovery, symptoms, emotional support

🚀 Quick Start

1. Visit this Space
2. Choose your language - English or Urdu tabs available
3. Ask questions via text or voice recording
4. Get compassionate, accurate responses about breast cancer

Example Questions to Try:

English:

• "What are the common side effects of chemotherapy?"
• "How can I manage fatigue during treatment?"
• "What exercises are safe after mastectomy?"

Urdu:

• "کیموتھراپی کے مضر اثرات کیا ہیں؟"
• "تھکاوٹ کیسے کم کریں؟"
• "ماسٹکٹومی کے بعد کون سی ورزشیں محفوظ ہیں؟"

🎙️ Voice Features

How Voice Input Works:

🎤 Record Voice → 📝 Convert to Text → 🤖 AI Processing → 💬 Text Response

text

Supported Voice Languages:

• English - Clear, natural speech
• Urdu - Urdu speech recognition

Voice Input Tips:

• Speak clearly and at a normal pace
• Use a quiet environment for better accuracy
• Keep queries under 30 seconds for best results

🏥 Medical Focus Areas

• Treatment options and side effects
• Recovery and rehabilitation guidance
• Emotional and psychological support
• Symptom management
• Fertility preservation
• Lifestyle and nutrition advice

⚠️ Important Medical Disclaimer

This AI assistant provides general breast cancer information and emotional support but is NOT a substitute for professional medical advice, diagnosis, or treatment.

Always consult qualified healthcare providers for medical decisions.

Limitations:

• Provides general information only
• Cannot diagnose medical conditions
• Not for emergency medical situations
• Always verify with healthcare professionals

🆘 Emergency Resources

If you're experiencing a medical emergency:

• Call emergency services immediately
• Contact your healthcare provider
• Reach crisis helplines in your country

🔧 Technical Details

System Architecture:

Frontend → FastAPI Backend → RAG System → OpenRouter LLM

↓ ↓ ↓ ↓

User Interface STT Processing Vector Search AI Model Voice Recording Caching System Emotional Analysis

text

Response Flow:

• Voice Input: Converted to text, processed, text response returned
• Text Input: Directly processed, text response returned
• No Audio Output: All responses are text-only for clarity

---

Built with ❤️ for breast cancer patients and their families