🏥 AI-Powered Health Assistant that translates medical reports into simple voice explanations
Millions of patients struggle to understand their medical reports, lab results, and prescriptions. This leads to medication non-compliance, anxiety, and health disparities.
MedVoice Companion uses Google Gemini's multimodal AI to:
- 📄 Analyze medical documents (PDFs, images, text)
- 🗣️ Explain results in simple, spoken language
- 👴 Assist elderly and visually impaired users via voice
- 🌍 Translate explanations to multiple languages
- Python 3.10+
- Node.js 18+ (optional, for development)
- Gemini API Key from Google AI Studio
# Clone the repository
git clone https://github.com/yourusername/medvoice-companion.git
cd medvoice-companion
# Create virtual environment
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
# Install dependencies
pip install -r requirements.txt
# Configure environment
cp .env.example .env
# Edit .env and add your GEMINI_API_KEY
# Run the application
python -m uvicorn backend.main:app --reload --port 8000Navigate to http://localhost:8000 in your browser.
MedVoice Companion
├── backend/
│ ├── main.py # FastAPI application
│ ├── models.py # Pydantic schemas
│ └── services/
│ ├── gemini_service.py # Gemini API integration
│ └── tts_service.py # Text-to-Speech service
├── frontend/
│ ├── index.html # Main application
│ ├── css/styles.css # Glassmorphic UI
│ └── js/app.js # Application logic
└── requirements.txt
| Feature | Description |
|---|---|
| 📋 Medical Report Reader | Upload PDFs/images, get simple explanations |
| 🧪 Lab Result Interpreter | Understand what your blood tests mean |
| 💊 Medication Explainer | Learn about your prescriptions |
| 🎙️ Voice Assistant | Hands-free interaction |
| ♿ Accessibility | High contrast, large text, screen reader support |
- All processing is done securely via Gemini API
- No medical data is stored permanently
- User consent is required for all operations
MIT License - See LICENSE for details.
Built with ❤️ for the Gemini 3 Vibe Coding Hackathon by Tarek Tarabichi from 2TInteractive.com