Skip to content
Back to search

WellAlly-health

Ally-Health is an intelligent healthcare assistant that harnesses advanced AI technology and medical expertise to transform personal health management. Through natural language interaction, it helps users record symptoms, manage medications, organize medical records, and access multidisciplinary health insights—making healthcare more intelligent, p

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/huifer--wellally-health/badge.svg)](/listings/huifer--wellally-health)

HTML

<a href="/listings/huifer--wellally-health"><img src="/api/listings/huifer--wellally-health/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

> Prerequisite: [Claude Code](https://claude.com/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.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 269 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # WellAlly Health — Privacy-First Personal Health Intelligence System
  2. [![English](https://img.shields.io/badge/lang-English-blue.svg)](README.md)
  3. [![中文](https://img.shields.io/badge/lang-中文-red.svg)](README.zh-CN.md)
  4. [![GitHub stars](https://img.shields.io/github/stars/huifer/WellAlly-health?style=social)](https://github.com/huifer/WellAlly-health)
  5. [![GitHub forks](https://img.shields.io/github/forks/huifer/WellAlly-health?style=social)](https://github.com/huifer/WellAlly-health)
  6. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
  7. [![Last Commit](https://img.shields.io/github/last-commit/huifer/WellAlly-health)](https://github.com/huifer/WellAlly-health/commits/main)
  8. [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/huifer/WellAlly-health/blob/main/.github/CONTRIBUTING.md)
  9. [![Made with Claude Code](https://img.shields.io/badge/made%20with-Claude%20Code-ff6f00.svg)](https://claude.com/claude-code)
  10. [![Star History Chart](https://api.star-history.com/svg?repos=huifer/WellAlly-health&type=date&legend=top-left)](https://www.star-history.com/#huifer/WellAlly-health&type=date&legend=top-left)
  11. **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.
  12. > **GitHub**: https://github.com/huifer/WellAlly-health
  13. > **⚠️ Disclaimer**: This project is **NOT** affiliated with, endorsed by, or associated with [Anthropic](https://www.anthropic.com/) or [Claude.ai](https://claude.ai/). It is an independent open-source project developed by [WellAlly Tech](https://www.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.
  14. >
  15. > **This is not a medical device.** All analysis is for personal reference only and must never replace professional medical advice.
  16. ## Table of Contents
  17. - [Why WellAlly Health](#why-wellally-health)
  18. - [✨ Features](#-features)
  19. - [🚀 Quick Start](#-quick-start)
  20. - [📂 Directory Structure](#-directory-structure)
  21. - [🧩 Command Reference (60+)](#-command-reference-60)
  22. - [👨‍⚕️ Specialist Domains](#-specialist-domains)
  23. - [🛠️ Analysis Skills](#️-analysis-skills)
  24. - [🔧 Technical Architecture](#-technical-architecture)
  25. - [💊 Drug Interaction Database](#-drug-interaction-database)
  26. - [🔒 Data Privacy](#-data-privacy)
  27. - [🗺️ Roadmap](#️-roadmap)
  28. - [🤝 Contributing](#-contributing)
  29. - [🛡️ Security](#️-security)
  30. - [⚠️ Important Safety Statement](#-important-safety-statement)
  31. - [📄 License](#-license)
  32. ## Why WellAlly Health
  33. 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:
  34. - **🔒 Truly private** — everything lives in plain files on your disk. Nothing leaves your machine.
  35. - **📄 Zero effort ingestion** — drop in a photo of a lab report or discharge summary; AI extracts the structured data for you.
  36. - **🧠 AI that knows your history** — drug-interaction checks, multi-specialty analysis, and trend tracking all understand *your* records.
  37. - **🗂️ One searchable source of truth** — biochemical values, imaging, surgeries, radiation exposure, medications, and allergies in one place.
  38. - **♻️ Yours forever** — open JSON + Markdown format, no lock-in, easy to back up or export.
  39. WellAlly Health is the **personal health record (PHR)** / **personal health information system (PHIS)** for people who want AI assistance *without* surrendering their medical privacy.
  40. ## ✨ Features
  41. **Local-first & private**
  42. - 📁 Pure file-based storage (JSON + Markdown), **no database required**
  43. - 💾 100% on-device — no uploads, no telemetry, no external accounts
  44. - 🔓 Open format you fully own and can back up anywhere
  45. **Intelligent medical document understanding**
  46. - 🖼️ Medical report image recognition (OCR + AI structuring)
  47. - 📊 Automatic biochemical test value & reference-range extraction
  48. - 🔍 Structured medical imaging data extraction
  49. - 📋 Structured discharge summary storage
  50. **Clinical safety intelligence**
  51. - 💊 **Drug interaction detection** — drug–drug, drug–disease, drug–dose, drug–food
  52. - 🚨 **Five-level severity warning system** (A / B / C / D / X, where X = absolute contraindication)
  53. - ☢️ Medical radiation dose tracking (BSA-adjusted + decay model)
  54. - 🔪 Surgery history & implant management
  55. - 👤 User profile, allergy, and medication management
  56. **Multi-disciplinary expertise**
  57. - 👨‍⚕️ **Multi-Disciplinary Team (MDT) consultation** across 16 specialty domains
  58. - 🔬 13+ single-specialist deep-dive analyses
  59. - 🧩 20 specialized analysis skills (sleep, nutrition, fitness, mental health, TCM constitution, and more)
  60. **Whole-lifecycle coverage**
  61. - 🧒 Child health (development, illness, nutrition, sleep, vaccination, safety)
  62. - 🤰 Women's & men's health (cycle, pregnancy, postpartum, menopause, fertility, prostate)
  63. - 🩺 Chronic disease management (diabetes, hypertension, COPD, cognitive health)
  64. - 🧘 Lifestyle & wellness (diet, goal, travel, occupational, rehabilitation)
  65. - 🌿 Traditional Chinese Medicine constitution analysis
  66. ## 🚀 Quick Start
  67. > Prerequisite: [Claude Code](https://claude.com/claude-code) installed and opened in this project directory.
  68. ```bash
  69. # 1. First-time setup — set height(cm) weight(kg) birthdate
  70. /profile set 175 70 1990-01-01
  71. # 2. Save your first lab report from an image
  72. /save-report /path/to/image.jpg
  73. # 3. Record a radiation scan
  74. /radiation add CT chest
  75. # 4. Record a past surgery in plain language
  76. /surgery Gallbladder removal surgery in August last year due to gallstones
  77. # 5. Save a discharge summary from a photo
  78. /discharge @医疗报告/出院小结.jpg
  79. # 6. Query everything
  80. /query all
  81. # 7. Start a multi-disciplinary consultation
  82. /consult
  83. ```
  84. That's it — no programming, no server, no sign-up.
  85. ## 📂 Directory Structure
  86. ```
  87. my-his/
  88. ├── .claude/
  89. │ ├── commands/ # 60+ slash commands (see Command Reference)
  90. │ │ ├── save-report.md
  91. │ │ ├── query.md
  92. │ │ ├── profile.md
  93. │ │ ├── radiation.md
  94. │ │ ├── surgery.md
  95. │ │ ├── discharge.md
  96. │ │ ├── medication.md
  97. │ │ ├── interaction.md
  98. │ │ ├── consult.md
  99. │ │ └── specialist.md
  100. │ └── specialists/ # 16 specialty + MDT coordinator Skills
  101. ├── data/
  102. │ ├── profile.json # User basic profile
  103. │ ├── radiation-records.json
  104. │ ├── allergies.json
  105. │ ├── interactions/ # Drug interaction database + logs
  106. │ │ ├── interaction-db.json
  107. │ │ └── interaction-logs/
  108. │ ├── medications/
  109. │ ├── 生化检查/ # Biochemical test data (YYYY-MM/...)
  110. │ ├── 影像检查/ # Medical imaging data + image backups
  111. │ ├── 手术记录/ # Surgery history
  112. │ ├── 出院小结/ # Discharge summaries
  113. │ └── index.json # Global index
  114. └── README.md
  115. ```
  116. ## 🧩 Command Reference (60+)
  117. WellAlly Health ships **62 slash commands**. Highlights by domain:
  118. **Core data management**
  119. `/profile` · `/get-profile` · `/query` · `/save-report` · `/report` · `/report-instructions` · `/prepare` · `/ai` · `/consult` · `/specialist` · `/allergy` · `/medication` · `/interaction` · `/surgery` · `/discharge` · `/radiation` · `/radiation-data` · `/symptom` · `/screening` · `/polypharmacy`
  120. **Specialty analysis**
  121. `/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`
  122. **Child & family**
  123. `/family` · `/child-development` · `/child-illness` · `/child-mental` · `/child-nutrition` · `/child-safety` · `/child-sleep` · `/child-vaccine`
  124. **Women's & men's health**
  125. `/cycle` · `/pregnancy` · `/postpartum` · `/menopause` · `/puberty` · `/male-menopause` · `/male-fertility` · `/prostate-health`
  126. **Chronic disease & aging**
  127. `/hypertension` · `/diabetes` · `/copd` · `/growth` · `/vaccine` · `/vaccination` · `/travel-health` · `/fall` · `/goal`
  128. > 💡 Full command specs and examples: [User Guide (EN)](docs/user-guide.en.md) · [用户指南(中文)](docs/user-guide.md)
  129. ## 👨‍⚕️ Specialist Domains
  130. 16 clinical specialty domains, coordinated by an MDT consultation orchestrator:
  131. | # | Specialty | # | Specialty |
  132. |---|-----------|---|-----------|
  133. | 1 | Cardiology (心内科) | 9 | Neurology (神经内科) |
  134. | 2 | Dermatology (皮肤科) | 10 | Oncology (肿瘤科) |
  135. | 3 | Endocrinology (内分泌科) | 11 | Orthopedics (骨科) |
  136. | 4 | Gastroenterology (消化科) | 12 | Pediatrics (儿科) |
  137. | 5 | General Practice (全科) | 13 | Psychiatry (精神科) |
  138. | 6 | Geriatrics (老年科) | 14 | Respiratory (呼吸科) |
  139. | 7 | Gynecology (妇科) | 15 | Urology (泌尿科) |
  140. | 8 | Hematology (血液科) | 16 | Nephrology (肾内科) |
  141. Use `/consult` for a full MDT review or `/specialist <domain>` for a focused deep dive.
  142. ## 🛠️ Analysis Skills
  143. 20 reusable analysis skills power the commands above:
  144. `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`
  145. ## 🔧 Technical Architecture
  146. - **Storage** — JSON files + filesystem directory layout (no database, fully portable)
  147. - **Command system** — Claude Code slash commands (natural-language friendly)
  148. - **Expert system** — multi-specialty Skill definitions + Subagent architecture
  149. - **Consultation coordination** — parallel processing + opinion-integration algorithm
  150. - **Document understanding** — AI visual analysis + intelligent text recognition/structuring
  151. - **Radiation modeling** — body-surface-area adjustment + exponential decay model
  152. > 🔧 Deep dive: [Technical Implementation Details (中文)](docs/technical-details.md) · [Data Structure Spec](docs/data-structures.en.md)
  153. ## 💊 Drug Interaction Database
  154. 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)**.
  155. - 🔍 Auto-detect interactions in your current medication combination
  156. - 🚨 Severity-graded warnings (A = negligible → X = absolute contraindication)
  157. - 📋 Detailed management recommendations & monitoring indicators
  158. - 💾 Custom rules and check history
  159. ```bash
  160. /interaction check # check current medications
  161. /interaction list # list all rules
  162. /interaction list X # show absolute-contraindication rules
  163. ```
  164. > 📖 [Drug Interaction Database Guide (中文)](docs/drug-interaction-database.md) — medical professionals welcome to contribute.
  165. ## 🔒 Data Privacy
  166. - ✅ All data stored on your local filesystem
  167. - ✅ No uploads to any cloud service
  168. - ✅ No external database or network dependency
  169. - ✅ Fully private, portable, and exportable
  170. WellAlly Health is designed for people who treat their medical history as strictly personal.
  171. ## 🗺️ Roadmap
  172. - Expanded specialty coverage and deeper longitudinal trend analytics
  173. - Richer data visualization and export formats
  174. - Community-contributed interaction rules and knowledge base
  175. - Local LLM option for fully offline operation
  176. See [`docs/plans`](docs/plans) for design notes.
  177. ## 🤝 Contributing
  178. Contributions are welcome! Whether it's a new command, a specialist Skill, interaction rules, translations, or docs — we'd love your help.
  179. - 📖 [Contributing Guide](.github/CONTRIBUTING.md)
  180. - 🐛 [Report a bug](https://github.com/huifer/WellAlly-health/issues/new?template=bug_report.md)
  181. - 💡 [Request a feature](https://github.com/huifer/WellAlly-health/issues/new?template=feature_request.md)
  182. - 🏷️ Look for [**good first issue**](https://github.com/huifer/WellAlly-health/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) to get started
  183. - 💬 Join the conversation in [GitHub Discussions](https://github.com/huifer/WellAlly-health/discussions)
  184. ## 🛡️ Security
  185. Found a vulnerability? Please follow our [Security Policy](.github/SECURITY.md) and report privately — do **not** open a public issue.
  186. ## ⚠️ Important Safety Statement
  187. This system strictly follows medical safety principles:
  188. 1. **Does not provide specific medication dosages**
  189. 2. **Does not directly prescribe prescription drugs**
  190. 3. **Does not predict life prognosis**
  191. 4. **Does not replace a doctor's diagnosis**
  192. 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.
  193. ## 📄 License
  194. Released under the [MIT License](LICENSE).
  195. **Important Disclaimer**: WellAlly Health is for personal health management only and is not a substitute for professional medical diagnosis or treatment.
  196. ---
  197. Developed and maintained by [WellAlly Tech](https://www.wellally.tech/).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.