README.md

---
title: Lifestyle Journey MVP
emoji: 🏥
colorFrom: blue
colorTo: green
sdk: gradio
sdk_version: 5.44.1
app_file: huggingface_space.py
pinned: false
license: mit
---

# 🏥 Lifestyle Journey MVP

Тестовий чат-бот з медичним асистентом та lifestyle коучингом на базі Gemini API.

## ⚡ Швидкий старт

1. **Налаштуйте API ключ** в розділі Settings → Variables and secrets
   - Додайте змінну `GEMINI_API_KEY` з вашим Gemini API ключем

2. **Почніть тестування:**
   - Медичні питання: "У мене болить груди"
   - Lifestyle: "Хочу почати займатися спортом"

## 🎯 Функціонал

### Entry Classifier (K/V/T формат)
- **Розумна класифікація** повідомлень: off/on/hybrid
- **М'який медичний тріаж** для делікатного підходу
- **Timestamp відстеження** для аналітики

### Medical Assistant  
- Медичні консультації з урахуванням хронічних станів
- Безпечні рекомендації та тріаж
- Направлення до лікарів при red flags

### Main Lifestyle Assistant
- **3 розумні дії:** gather_info, lifestyle_dialog, close
- Персоналізовані поради з урахуванням медичних обмежень
- Автоматичне управління lifecycle сесій
- Контрольоване оновлення профілю пацієнта

## 🧪 Тестові сценарії

```
🚨 Медичні ургентні стани:
- "У мене сильний біль у грудях"
- "Тиск 190/110, що робити?"
- "Втрачаю свідомість"

💚 Lifestyle коучинг:
- "Хочу схуднути безпечно"  
- "Які вправи можна при діабеті?"
- "Допоможіть скласти план харчування"

🔄 Гібридні запити (V=hybrid):
- "Чи можна бігати з гіпертонією?"
- "Болить спина після тренувань"
- "Хочу займатися спортом, але у мене болить спина"
```

## 📊 Архітектура

```mermaid
graph TD
    A[Повідомлення пацієнта] --> B[Entry Classifier]
    B --> C{K/V/T формат}
    C -->|V=off| D[Soft Medical Triage]
    C -->|V=on| E[Main Lifestyle Assistant]
    C -->|V=hybrid| F[Medical + Triage Exit]
    F --> G{Готовий до lifestyle?}
    G -->|Так| E
    G -->|Ні| D
    E --> H{Action?}
    H -->|close| I[Update Profile + Medical]
    H -->|continue| J[Lifestyle Dialog]
```

## ⚠️ Важлива інформація

- **Тільки для тестування** - не замінює медичну допомогу
- При серйозних симптомах - звертайтесь до лікаря
- API ключ зберігається безпечно в HuggingFace Spaces

## 🔧 Для розробників

Якщо хочете запустити локально:

```bash
git clone <this-repo>
pip install -r requirements.txt
cp .env.example .env
# Додайте ваш GEMINI_API_KEY в .env
python app.py
```

---

Made with ❤️ for healthcare innovation