Claude-Ally-Health - Personal Health Information System
A file-based personal health data management system using Claude Code CLI tools for data management.
GitHub: https://github.com/huifer/Claude-Ally-Health
⚠️ Disclaimer: This project is NOT affiliated with, endorsed by, or associated with Anthropic or Claude.ai. This is an independent open-source project developed by WellAlly Tech.
📝 Note: This project uses GLM's
mcp__4_5v_mcp__analyze_imagefor image recognition.
Project Developer
This project is developed and maintained by WellAlly Tech.
System Features
- 📁 Pure file-based storage, no database required
- 🖼️ Intelligent medical report image recognition
- 📊 Automatic biochemical test data and reference range extraction
- 🔍 Structured medical imaging data extraction
- 🔪 Surgical history and implant management
- 📋 Structured discharge summary storage
- 👨⚕️ Multi-Disciplinary Team (MDT) consultation system
- 🔬 13 medical specialist intelligent analysis
- ☢️ Medical radiation dose tracking and management
- 💊 Intelligent drug interaction detection (New)
- 🚨 Five-level severity warning system (A/B/C/D/X)
- 👤 User basic profile management
- 💾 Local storage, completely private data
- 🚀 Claude Code command operations, no programming required
Directory Structure
my-his/
├── .claude/
│ ├── commands/
│ │ ├── save-report.md # Save medical report command
│ │ ├── query.md # Query records command
│ │ ├── profile.md # User profile settings command
│ │ ├── radiation.md # Radiation exposure management command
│ │ ├── surgery.md # Surgery history record command
│ │ ├── discharge.md # Discharge summary management command
│ │ ├── medication.md # Medication record management command
│ │ ├── interaction.md # Drug interaction detection command
│ │ ├── consult.md # Multi-disciplinary consultation command
│ │ └── specialist.md # Single specialist consultation command
│ └── specialists/
│ ├── cardiology.md # Cardiology specialist Skill
│ ├── endocrinology.md # Endocrinology specialist Skill
│ ├── gastroenterology.md # Gastroenterology specialist Skill
│ ├── nephrology.md # Nephrology specialist Skill
│ ├── hematology.md # Hematology specialist Skill
│ ├── respiratory.md # Respiratory medicine specialist Skill
│ ├── neurology.md # Neurology specialist Skill
│ ├── oncology.md # Oncology specialist Skill
│ ├── general.md # General practice specialist Skill
│ └── consultation-coordinator.md # Consultation coordinator
├── data/
│ ├── profile.json # User basic profile
│ ├── radiation-records.json # Radiation exposure records
│ ├── allergies.json # Allergy history records
│ ├── interactions/ # Drug interaction database
│ │ ├── interaction-db.json # Interaction rules main database
│ │ └── interaction-logs/ # Check history records
│ ├── medications/ # Medication record data
│ ├── 生化检查/ # Biochemical test data
│ │ └── YYYY-MM/
│ │ └── YYYY-MM-DD_test_name.json
│ ├── 影像检查/ # Medical imaging data
│ │ └── YYYY-MM/
│ │ ├── YYYY-MM-DD_test_name_body_part.json
│ │ └── images/ # Original image backup
│ ├── 手术记录/ # Surgery history data
│ │ └── YYYY-MM/
│ │ └── YYYY-MM-DD_surgery_name.json
│ ├── 出院小结/ # Discharge summary data
│ │ └── YYYY-MM/
│ │ └── YYYY-MM-DD_main_diagnosis.json
│ └── index.json # Global index file
└── README.md
Quick Navigation
- 📖 Complete User Guide (Chinese) | docs/user-guide.en.md (English) - Detailed command usage instructions and examples
- 📋 Data Structure Specification (Chinese) | docs/data-structures.en.md (English) - JSON data format and field descriptions
- 🔧 Technical Implementation Details (Chinese) - System architecture and technical details
- ⚠️ Safety Guidelines and Usage Limitations (Chinese) - Safety principles and disclaimer
Quick Start
- Ensure Claude Code is installed
- Open Claude Code in the current directory
- First-time setup:
/profile set 175 70 1990-01-01 - Save first report:
/save-report /path/to/image.jpg - Record radiation:
/radiation add CT chest - Record surgery:
/surgery Gallbladder removal surgery in August last year due to gallstones - Save discharge summary:
/discharge @医疗报告/出院小结.jpg - Query all records:
/query all - Start MDT consultation:
/consult
Data Privacy
- All data stored on local filesystem
- No uploads to any cloud services
- No external database dependencies
- Completely private management
Core Commands Overview
| Command | Function | Description |
|---------|----------|-------------|
| /profile | User basic parameters | Set height, weight, birth date |
| /save-report | Save medical report | Support biochemical and imaging tests |
| /radiation | Radiation management | Record and track radiation exposure |
| /surgery | Surgery history | Record surgery information and implants |
| /discharge | Discharge summary | Save and structure discharge summaries |
| /medication | Medication management | Manage medication plans and records |
| /interaction | Interaction detection | Detect drug interactions |
| /allergy | Allergy history management | Record and manage allergy history |
| /query | Query records | Multi-condition medical data queries |
| /consult | Multi-disciplinary consultation | Comprehensive analysis across 13 specialties |
| /specialist | Single specialist consultation | Consult specific specialty experts |
💡 For detailed usage, refer to Complete User Guide
Technical Features
- Storage Method: JSON files + filesystem directory structure
- Command System: Claude Code Slash Commands
- Expert System: Multi-specialty Skill definitions + Subagent architecture
- Consultation Coordination: Parallel processing + opinion integration algorithms
- Image Recognition: AI visual analysis
- Data Extraction: Intelligent text recognition and structuring
- Radiation Calculation: Body surface area adjustment + exponential decay model
🔧 For more technical details, refer to Technical Implementation Details (Chinese)
⚠️ Important Safety Statement
This system strictly follows medical safety principles:
- Does not provide specific medication dosages
- Does not directly prescribe prescription drugs
- Does not predict life prognosis
- Does not replace doctor diagnosis
All analysis reports from this system are for reference only and should not be used as a basis for medical diagnosis. All medical decisions require consultation with professional doctors. In case of emergency, seek immediate medical attention.
⚠️ For complete safety principles and usage limitations, refer to Safety Guidelines Document (Chinese)
💊 Drug Interaction Database
The system includes intelligent drug interaction detection, supporting drug-drug, drug-disease, drug-dose, and drug-food interaction detection using a five-level severity classification system (A/B/C/D/X).
Core Features:
- 🔍 Automatically detect interactions in current medication combinations
- 🚨 Severity-graded warnings (A/B/C/D/X)
- 📋 Provide detailed management recommendations and monitoring indicators
- 💾 Support custom rules and history records
Quick Start:
# Check interactions for current medications
/interaction check
# List all interaction rules
/interaction list
# View absolute contraindication rules
/interaction list X
📖 Detailed Documentation: Drug Interaction Database Complete Guide (Chinese)
🩺 Professional Contributions: Medical professionals are welcome to help improve the database → Contribution Guidelines (Chinese)
License
This project is open-sourced under the MIT License.
Important Disclaimer: This system is for personal health management only and should not be used as a basis for medical diagnosis.