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

Note: This project uses GLM’s mcp__4_5v_mcp__analyze_image for 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

1. Ensure Claude Code is installed
2. Open Claude Code in the current directory
3. First-time setup: /profile set 175 70 1990-01-01
4. Save first report: /save-report /path/to/image.jpg
5. Record radiation: /radiation add CT chest
6. Record surgery: /surgery Gallbladder removal surgery in August last year due to gallstones
7. Save discharge summary: /discharge @医疗报告/出院小结.jpg
8. Query all records: /query all
9. 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:

1. Does not provide specific medication dosages
2. Does not directly prescribe prescription drugs
3. Does not predict life prognosis
4. 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.