Advocate_Life_Style / README.md
DocUA's picture
Docs: cleanup and create current architecture guide
81f922c
metadata
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):
- "Чи можна бігати з гіпертонією?"
- "Болить спина після тренувань"
- "Хочу займатися спортом, але у мене болить спина"

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

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

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

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

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