WellAlly Health is a local-first, AI-powered personal health record (PHR) system. It turns your medical reports, prescriptions, imaging, and daily health tracking into a private, searchable, structured knowledge base that runs entirely on your own machine — no cloud, no database server, no account required.

GitHub: https://github.com/huifer/WellAlly-health

⚠️ Disclaimer: This project is NOT affiliated with, endorsed by, or associated with Anthropic or Claude.ai. It is an independent open-source project developed by WellAlly Tech. WellAlly Health is built on top of Claude Code's command-line tooling and uses AI image recognition (e.g. GLM mcp__4_5v_mcp__analyze_image) for document understanding.

This is not a medical device. All analysis is for personal reference only and must never replace professional medical advice.

• Why WellAlly Health
• ✨ Features
• 🚀 Quick Start
• 📂 Directory Structure
• 🧩 Command Reference (60+)
• 👨‍⚕️ Specialist Domains
• 🛠️ Analysis Skills
• 🔧 Technical Architecture
• 💊 Drug Interaction Database
• 🔒 Data Privacy
• 🗺️ Roadmap
• 🤝 Contributing
• 🛡️ Security
• ⚠️ Important Safety Statement
• 📄 License

Your health data is scattered across hospital portals, paper printouts, photos, and memory. Commercial apps ask you to upload it to their cloud. WellAlly Health takes the opposite approach:

• 🔒 Truly private — everything lives in plain files on your disk. Nothing leaves your machine.
• 📄 Zero effort ingestion — drop in a photo of a lab report or discharge summary; AI extracts the structured data for you.
• 🧠 AI that knows your history — drug-interaction checks, multi-specialty analysis, and trend tracking all understand your records.
• 🗂️ One searchable source of truth — biochemical values, imaging, surgeries, radiation exposure, medications, and allergies in one place.
• ♻️ Yours forever — open JSON + Markdown format, no lock-in, easy to back up or export.

WellAlly Health is the personal health record (PHR) / personal health information system (PHIS) for people who want AI assistance without surrendering their medical privacy.

Local-first & private

• 📁 Pure file-based storage (JSON + Markdown), no database required
• 💾 100% on-device — no uploads, no telemetry, no external accounts
• 🔓 Open format you fully own and can back up anywhere

Intelligent medical document understanding

• 🖼️ Medical report image recognition (OCR + AI structuring)
• 📊 Automatic biochemical test value & reference-range extraction
• 🔍 Structured medical imaging data extraction
• 📋 Structured discharge summary storage

Clinical safety intelligence

• 💊 Drug interaction detection — drug–drug, drug–disease, drug–dose, drug–food
• 🚨 Five-level severity warning system (A / B / C / D / X, where X = absolute contraindication)
• ☢️ Medical radiation dose tracking (BSA-adjusted + decay model)
• 🔪 Surgery history & implant management
• 👤 User profile, allergy, and medication management

Multi-disciplinary expertise

• 👨‍⚕️ Multi-Disciplinary Team (MDT) consultation across 16 specialty domains
• 🔬 13+ single-specialist deep-dive analyses
• 🧩 20 specialized analysis skills (sleep, nutrition, fitness, mental health, TCM constitution, and more)

Whole-lifecycle coverage

• 🧒 Child health (development, illness, nutrition, sleep, vaccination, safety)
• 🤰 Women's & men's health (cycle, pregnancy, postpartum, menopause, fertility, prostate)
• 🩺 Chronic disease management (diabetes, hypertension, COPD, cognitive health)
• 🧘 Lifestyle & wellness (diet, goal, travel, occupational, rehabilitation)
• 🌿 Traditional Chinese Medicine constitution analysis

Prerequisite: Claude Code installed and opened in this project directory.

# 1. First-time setup — set height(cm) weight(kg) birthdate
/profile set 175 70 1990-01-01

# 2. Save your first lab report from an image
/save-report /path/to/image.jpg

# 3. Record a radiation scan
/radiation add CT chest

# 4. Record a past surgery in plain language
/surgery Gallbladder removal surgery in August last year due to gallstones

# 5. Save a discharge summary from a photo
/discharge @医疗报告/出院小结.jpg

# 6. Query everything
/query all

# 7. Start a multi-disciplinary consultation
/consult

That's it — no programming, no server, no sign-up.

my-his/
├── .claude/
│   ├── commands/            # 60+ slash commands (see Command Reference)
│   │   ├── save-report.md
│   │   ├── query.md
│   │   ├── profile.md
│   │   ├── radiation.md
│   │   ├── surgery.md
│   │   ├── discharge.md
│   │   ├── medication.md
│   │   ├── interaction.md
│   │   ├── consult.md
│   │   └── specialist.md
│   └── specialists/         # 16 specialty + MDT coordinator Skills
├── data/
│   ├── profile.json          # User basic profile
│   ├── radiation-records.json
│   ├── allergies.json
│   ├── interactions/         # Drug interaction database + logs
│   │   ├── interaction-db.json
│   │   └── interaction-logs/
│   ├── medications/
│   ├── 生化检查/             # Biochemical test data (YYYY-MM/...)
│   ├── 影像检查/             # Medical imaging data + image backups
│   ├── 手术记录/             # Surgery history
│   ├── 出院小结/             # Discharge summaries
│   └── index.json            # Global index
└── README.md

WellAlly Health ships 62 slash commands. Highlights by domain:

Core data management /profile · /get-profile · /query · /save-report · /report · /report-instructions · /prepare · /ai · /consult · /specialist · /allergy · /medication · /interaction · /surgery · /discharge · /radiation · /radiation-data · /symptom · /screening · /polypharmacy

Specialty analysis /sleep · /nutrition · /diet · /fitness · /mental-health · /mood · /psych-assess · /cognitive · /tcm-constitution · /skin-health · /oral-health · /eye-health · /ent · /sexual-health · /occupational-health · /rehabilitation · /infection · /rheumatology

Child & family /family · /child-development · /child-illness · /child-mental · /child-nutrition · /child-safety · /child-sleep · /child-vaccine

Women's & men's health /cycle · /pregnancy · /postpartum · /menopause · /puberty · /male-menopause · /male-fertility · /prostate-health

Chronic disease & aging /hypertension · /diabetes · /copd · /growth · /vaccine · /vaccination · /travel-health · /fall · /goal

💡 Full command specs and examples: User Guide (EN) · 用户指南（中文）

16 clinical specialty domains, coordinated by an MDT consultation orchestrator:

Use /consult for a full MDT review or /specialist <domain> for a focused deep dive.

20 reusable analysis skills power the commands above:

ai-analyzer · emergency-card · family-health-analyzer · fitness-analyzer · food-database-query · goal-analyzer · health-trend-analyzer · infection-specialist · mental-health-analyzer · nutrition-analyzer · occupational-health-analyzer · oral-health-analyzer · rehabilitation-analyzer · sexual-health-analyzer · skin-health-analyzer · sleep-analyzer · tcm-constitution-analyzer · travel-health-analyzer · weightloss-analyzer · wellally-tech

• Storage — JSON files + filesystem directory layout (no database, fully portable)
• Command system — Claude Code slash commands (natural-language friendly)
• Expert system — multi-specialty Skill definitions + Subagent architecture
• Consultation coordination — parallel processing + opinion-integration algorithm
• Document understanding — AI visual analysis + intelligent text recognition/structuring
• Radiation modeling — body-surface-area adjustment + exponential decay model

🔧 Deep dive: Technical Implementation Details (中文) · Data Structure Spec

Built-in drug interaction detection covering drug–drug, drug–disease, drug–dose, and drug–food interactions, graded by a five-level severity system (A/B/C/D/X).

• 🔍 Auto-detect interactions in your current medication combination
• 🚨 Severity-graded warnings (A = negligible → X = absolute contraindication)
• 📋 Detailed management recommendations & monitoring indicators
• 💾 Custom rules and check history

/interaction check      # check current medications
/interaction list       # list all rules
/interaction list X     # show absolute-contraindication rules

📖 Drug Interaction Database Guide (中文) — medical professionals welcome to contribute.

• ✅ All data stored on your local filesystem
• ✅ No uploads to any cloud service
• ✅ No external database or network dependency
• ✅ Fully private, portable, and exportable

WellAlly Health is designed for people who treat their medical history as strictly personal.

• Expanded specialty coverage and deeper longitudinal trend analytics
• Richer data visualization and export formats
• Community-contributed interaction rules and knowledge base
• Local LLM option for fully offline operation

See docs/plans for design notes.

Contributions are welcome! Whether it's a new command, a specialist Skill, interaction rules, translations, or docs — we'd love your help.

• 📖 Contributing Guide
• 🐛 Report a bug
• 💡 Request a feature
• 🏷️ Look for good first issue to get started
• 💬 Join the conversation in GitHub Discussions

Found a vulnerability? Please follow our Security Policy and report privately — do not open a public issue.

This system strictly follows medical safety principles:

1. Does not provide specific medication dosages
2. Does not directly prescribe prescription drugs
3. Does not predict life prognosis
4. Does not replace a doctor's diagnosis

All analysis from this system is for reference only and is not a basis for medical diagnosis. All medical decisions require consultation with a qualified professional. In an emergency, seek immediate medical attention.

Released under the MIT License.

Important Disclaimer: WellAlly Health is for personal health management only and is not a substitute for professional medical diagnosis or treatment.

Developed and maintained by WellAlly Tech.