https://github.com/harishkotra/guided-health
GuidedHealth is a privacy-first healthcare application that generates personalized care journeys for chronic conditions using locally-run AI models and FDA drug information.
https://github.com/harishkotra/guided-health
fda gaia medical-ai
Last synced: about 2 months ago
JSON representation
GuidedHealth is a privacy-first healthcare application that generates personalized care journeys for chronic conditions using locally-run AI models and FDA drug information.
- Host: GitHub
- URL: https://github.com/harishkotra/guided-health
- Owner: harishkotra
- Created: 2025-08-23T20:05:13.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2025-08-23T20:29:06.000Z (about 2 months ago)
- Last Synced: 2025-08-24T08:22:15.068Z (about 2 months ago)
- Topics: fda, gaia, medical-ai
- Language: JavaScript
- Homepage: https://guided-health.up.railway.app/
- Size: 23.4 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# GuidedHealth - Privacy-First Healthcare Journey Generator
GuidedHealth is a privacy-first healthcare application that generates personalized care journeys for chronic conditions using locally-run AI models and FDA drug information.
## 🌟 Key Features
- **Privacy-First Approach**: All AI processing happens locally via Gaia node - your health data never leaves your environment
- **Personalized Care Journeys**: AI-generated step-by-step guidance for managing chronic conditions
- **FDA Drug Information**: Integrated access to medication data from the FDA database
- **User-Friendly Interface**: Clean, accessible design with Bootstrap components
- **Markdown Support**: Rich formatting for easy-to-read healthcare information
## 🏗️ Architecture
```mermaid
flowchart TD
User[User Browser] <--> WebUI[GuidedHealth Web UI
HTML/CSS/JavaScript]
WebUI --> Express[Express.js Server]
Express --> Gaia[Gaia AI Node
Local Inference]
Express --> FDA[FDA API
Public Drug Database]
subgraph LocalEnvironment [Local/Private Environment]
Gaia --> MedGemma[MedGemma-3-4B-IT Model
Medical Specialized AI]
end
subgraph ExternalServices [External Services]
FDA
end
style LocalEnvironment fill:#e1f5fe
style MedGemma fill:#bbdefb
```
## 🚀 How It Works
1. **User Input**: Patients describe their diagnosis or health concern
2. **Local AI Processing**: MedGemma model processes the input locally via Gaia node
3. **Care Journey Generation**: AI creates a personalized, step-by-step care plan
4. **FDA Drug Lookup**: System searches for relevant medications based on condition
5. **Results Display**: Information is presented in easy-to-understand cards with proper formatting
## 🔧 Technical Stack
- **Frontend**: HTML5, CSS3, JavaScript (ES6+), Bootstrap 5.3
- **Backend**: Node.js, Express.js
- **AI Inference**: Gaia node with MedGemma-3-4B-IT model
- **Data Sources**: FDA OpenAPI for drug information
- **Security**: Local processing, no external data storage
## 📦 Installation & Setup
### Prerequisites
- Node.js (v16 or higher)
- Gaia node with MedGemma-3-4B-IT model
- FDA API access (public, no key required)
### Environment Variables
Create a `.env` file with the following variables:
```env
PORT=3000
GAIA_NODE_URL=http://localhost:8228
GAIA_MODEL_NAME=medgemma-3-4b-it
GAIA_API_KEY=your_gaia_api_key
```
### Installation Steps
1. **Clone the repository**
```bash
git clone
cd GuidedHealth
```
2. **Install dependencies**
```bash
npm install
```
3. **Start the application**
```bash
npm start
```
4. **Access the application**
Open your browser and navigate to `http://localhost:3000`
## 🛡️ Privacy & Security
GuidedHealth is designed with privacy as a core principle:
- **Local AI Processing**: All health data is processed locally through your Gaia node
- **No Data Storage**: We don't store any personal health information
- **FDA API Only**: External calls are limited to public FDA drug information
- **Transparent Code**: Open-source implementation for complete transparency
## 🏥 Use Cases
- **New Diagnosis Education**: Understanding next steps after a chronic condition diagnosis
- **Medication Research**: Learning about drugs prescribed for specific conditions
- **Treatment Planning**: Creating personalized healthcare roadmaps
- **Patient Empowerment**: Providing accessible information for better health decisions
## 🧠 AI Model: MedGemma-3-4B-IT
GuidedHealth uses the specialized **MedGemma-3-4B-IT** model, which offers:
- **Medical Expertise**: Specifically trained on healthcare and medical literature
- **Local Execution**: Runs entirely on your hardware via Gaia node
- **Privacy Focused**: No data sent to external AI services
- **Efficient Size**: 4B parameter model balances performance and resource requirements
## 🌐 FDA Integration
The application integrates with the FDA's OpenAPI to provide:
- Drug purpose and indications
- Dosage information
- Safety warnings and contraindications
- Adverse reaction data
- Boxed warnings (when applicable)
## 🎨 UI/UX Features
- **Responsive Design**: Works on desktop, tablet, and mobile devices
- **Accessibility**: WCAG-compliant interface elements
- **Card-Based Layout**: Easy-to-digest information presentation
- **Loading States**: Clear feedback during AI processing
- **Example Prompts**: Quick-start templates for common conditions
## ⚠️ Medical Disclaimer
> GuidedHealth provides educational guidance generated by AI and publicly available data. This tool is **not** a substitute for professional medical advice, diagnosis, or treatment. Always consult your healthcare provider with any questions or concerns about your health or medications.
## 🔮 Future Enhancements
- Multi-language support
- Printable care journey reports
- Integration with personal health records (local-only)
- Expanded condition-specific templates
- Offline functionality for complete privacy
----------
**GuidedHealth** - Your private, AI-powered healthcare companion for navigating chronic conditions with confidence and clarity.