Repository navigation
Releases: wangzhengpengjay/AI-Health-Steward
Release list
v1.5.0 Mobile Pairing + Async Chat
Mobile pairing, async chat, security hardening. Android debug APK.
AI Health Steward v1.0.0-beta.2
AI Health Steward — v1.0.0-beta.2
Self-hosted, private, open-source family AI health steward. Turn multimodal health data into a structured personal health profile with a visual dashboard and AI consultation — built for single-family private deployment.
开源、可私有化部署的家庭 AI 健康管家。通过多模态大模型将健康数据结构化为人维度画像,提供可视化看板与 AI 咨询能力。
What's new since beta.1
- Chat persistence: conversation history is now saved and continued; the model receives a 30-minute sliding window instead of a fragile full history
- Streaming stability: fixed SSE
[DONE]termination so WebUI no longer gets stuck on "持续输出" - Chat extraction reliability: extracted metrics survive streaming, blood pressure systolic/diastolic share one timestamp, and duplicate old values are no longer re-recorded
- Report ingestion: multi-page PDFs are split per page and images compressed before multimodal extraction, supporting larger reports within API limits
- Extraction schema hardening:
metricsis now a strict white-list (BP, glucose, heart rate, weight/BMI); blood/body-fluid results route tolab, imaging/electrophysiology/nuclear medicine route toexamtimeline - Metric display: long lab/exam text values are stored and shown correctly; ECG parameters (P-R interval, QRS, QT/QTc, SV1/RV5, cardiac axis) now appear under the 心电图 exam tab
- Infra: backend hot-reload polling fixes stale code after bind-mount changes
Tech Stack
Python 3.12 + FastAPI · React 18 + Vite + TypeScript + TailwindCSS · PostgreSQL 16 + pgvector · SQLAlchemy 2.0 + Alembic · Docker Compose
Quick Start
git clone https://github.com/wangzhengpengjay/AI-Health-Steward.git
cd ai-health-steward
cp .env.example .env
# edit .env, set MULTIMODAL_API_KEY and TEXT_API_KEY
cp .env backend/.env
docker compose up -d
docker exec health-steward-backend alembic upgrade head
# WebUI: http://localhost:5173 | API docs: http://localhost:8000/docs
⚠️ Pre-release: V1.0 hardening (age-tiered reference ranges, critical-value alerts, family overview, long-term memory, auth & rate limiting) is in progress per the roadmap. See README for full roadmap.
AI Health Steward v1.0.0-beta.1
AI Health Steward — v1.0.0-beta.1
Self-hosted, private, open-source family AI health steward. Turn multimodal health data into a structured personal health profile with a visual dashboard and AI consultation — built for single-family private deployment.
开源、可私有化部署的家庭 AI 健康管家。通过多模态大模型将健康数据结构化为人维度画像,提供可视化看板与 AI 咨询能力。
What's included
- Dual-entry product design: WebUI (full management backend) + Feishu/Lark bot (lightweight daily entry)
- Multimodal report import — photo uploads of lab reports / prescriptions auto-extracted into structured metrics
- Person-centric health profile (A–H field families) as single source of truth
- AI health consultation — intent routing + tool calling grounded in your real profile data
- Trend visualization — BP / glucose / lipids / HR / weight & BMI with anomaly + critical-value alerts
- Personalized checkup recommendations — 1+X+Y logic, budget tiers, safety/contraindication screening
- RAG report retrieval — archived reports vectorized for semantic Q&A
- Periodic health summaries — auto weekly/monthly/yearly reports
- Risk self-assessment — PHQ-9, GAD-7, diabetes, ASCVD scales
- Follow-up / medication reminders, family multi-member isolation, auth + rate limiting
- Plug-in models — multimodal / text API / local LLM (Ollama), cost-optimized
Tech Stack
Python 3.12 + FastAPI · React 18 + Vite + TypeScript + TailwindCSS · PostgreSQL 16 + pgvector · SQLAlchemy 2.0 + Alembic · Docker Compose
Quick Start
git clone https://github.com/wangzhengpengjay/AI-Health-Steward.git
cd ai-health-steward
cp .env.example .env
# edit .env, set MULTIMODAL_API_KEY and TEXT_API_KEY
cp .env backend/.env
docker compose up -d
docker exec health-steward-backend alembic upgrade head
# WebUI: http://localhost:5173 | API docs: http://localhost:8000/docs
⚠️ Pre-release: V1.0 hardening (age-tiered reference ranges, critical-value alerts, family overview, long-term memory, auth & rate limiting) is in progress per the roadmap. See README for full roadmap.