LifeValue/HealthWallet.me
LifeValue/HealthWallet.me has 73 GitHub stars and 5 forks. GitHot measured 0 in 7 days and +1 in 15 days. Last checked 2026-11-15 17:32 UTC. Last push 2026-10-19.
What you can do
- AI Scan - Photograph or import medical documents; the on-device LLM extracts patient info, encounters, medications, allergies, and lab results into structured FHIR records
- Aggregate - Sync records from 52,000+ hospitals, clinics, and labs through FHIR R4 APIs
- Organize - Browse all records — conditions, medications, immunizations, lab results, clinical notes — in one place
- Share - Cross-platform proximity sharing — transfer records between iOS and Android devices, no internet needed. Data is view-only on the receiver side — never stored, screenshots blocked
Measured star growth
- in 24h
- Update delayed
- in 7 days
- 0
- in 15 days
- +1
- in 1 month
- Update delayed
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
Open-source, patient-controlled health record app with on-device AI. Aggregates medical data from 52K+ providers via FHIR R4. Offline-first. Flutter.
AIREADME.md
OriginalHealthWallet.me
Your medical records. On your phone. Under your control.
Open-source, offline-first health record manager with on-device AI. Connects to 52,000+ US healthcare providers via FHIR R4. Scans paper documents with a local LLM — your data never leaves your device.

About
HealthWallet.me is a patient-controlled, community-driven health record platform that consolidates your medical data from multiple providers into one accessible app.
Patient-Centered | Privacy-First | FHIR Compliant | Offline Capable
What makes it different:
- On-device AI — Scan paper documents and the built-in LLM extracts structured FHIR resources locally. No cloud. No uploads. No data leaks.
- 52,000+ providers — Connect to US healthcare systems through FHIR R4 APIs via a self-hosted FastenHealth backend.
- Truly offline — Full access to all your records without internet. Sync when you're ready.
- Proximity sharing — Share records face-to-face via AirDrop-style transfer. No intermediary server.
- International Patient Summary (IPS) — Export a globally recognized health summary for travel or emergencies.
- Emergency wallet card — Add your critical health info to Apple Wallet or Google Wallet.
Features
| Feature | Description |
|---|---|
| AI Scan | Photograph or import medical documents; the on-device LLM extracts patient info, encounters, medications, allergies, and lab results into structured FHIR records |
| Aggregate | Sync records from 52,000+ hospitals, clinics, and labs through FHIR R4 APIs |
| Organize | Browse all records — conditions, medications, immunizations, lab results, clinical notes — in one place |
| Share | Cross-platform proximity sharing — transfer records between iOS and Android devices, no internet needed. Data is view-only on the receiver side — never stored, screenshots blocked |
| Export | Generate an International Patient Summary PDF or add emergency info to Apple/Google Wallet |
| Secure | Face ID / fingerprint lock, local SQLite storage, no mandatory cloud dependency |
Quick Start
Install the App
Set Up Your Self-Hosted Backend
The backend (FastenHealth) aggregates medical records from healthcare providers and syncs them to your phone.
Prerequisites: Docker
curl https://raw.githubusercontent.com/fastenhealth/fasten-onprem/refs/heads/main/docker-compose-prod.yml -o docker-compose.yml && \
curl https://raw.githubusercontent.com/fastenhealth/fasten-onprem/refs/heads/main/set_env.sh -o set_env.sh && \
chmod +x ./set_env.sh && \
./set_env.sh && \
docker compose up -d
Then open http://localhost:9090, create an account, and you're ready.
Connect the App to Your Backend
- Generate an access token in your FastenHealth dashboard
- Scan the QR code with HealthWallet
- Your records sync automatically
On-Device AI — How It Works
HealthWallet runs a quantized LLM directly on your phone using llama.cpp. No API calls, no cloud processing — the model runs locally with Metal acceleration on iOS and CPU inference on Android.
Available Models
| Model | Size | Best For |
|---|---|---|
| Standard (Qwen3-VL-2B) | ~1.1 GB | Fast, lightweight, works on most devices |
| Advanced (MedGemma-4B) | ~2.5 GB | Higher accuracy for complex medical documents |
Deep Scan (optional vision projector) lets the AI read directly from photos instead of OCR text. One-time download: ~445 MB (Standard) or ~851 MB (Advanced).
Device Requirements
| Device | RAM | Capability |
|---|---|---|
| iPhone Pro/Pro Max | 6 GB+ | Full scanning (both models) |
| iPhone 13/14/15 | 4-6 GB | Standard model only |
| Android | 12 GB+ | Full scanning (both models) |
| Android | 10-11 GB | Standard model only |
Architecture
Built with Clean Architecture and feature-based modules in Flutter/Dart.
| Layer | Technology |
|---|---|
| State Management | BLoC (flutter_bloc) |
| Dependency Injection | GetIt + Injectable |
| Navigation | AutoRoute (type-safe) |
| Local Database | Drift (SQLite) |
| Networking | Dio |
| Code Generation | Freezed, JSON Serializable |
| Healthcare Standard | FHIR R4 |
| On-Device AI | llama.cpp via llamadart |
| Localization | Flutter Intl (EN, ES, DE) |
Project Structure
lib/
├── app/ # App configuration and initialization
├── core/ # Shared infrastructure
│ ├── config/ # App configuration and constants
│ ├── data/ # Local database (Drift/SQLite)
│ ├── di/ # Dependency injection setup
│ ├── l10n/ # Localization
│ ├── navigation/ # Router and route definitions
│ ├── services/ # Shared services
│ ├── theme/ # Colors, text styles, spacing
│ ├── utils/ # Utility functions
│ └── widgets/ # Reusable UI components
├── features/
│ ├── dashboard/ # Main tab navigation
│ ├── home/ # Health overview with reorderable grid
│ ├── records/ # Health records management + IPS export
│ ├── scan/ # AI document scanning (llama.cpp)
│ ├── sync/ # QR-based backend sync
│ ├── share_records/ # Proximity sharing (AirDrop-style)
│ ├── wallet_pass/ # Apple/Google Wallet emergency card
│ ├── user/ # Profile & patient management
│ ├── onboarding/ # First-launch flow
│ └── notifications/ # In-app notifications
└── gen/ # Generated code
Branch Strategy
| Branch | Purpose | CI/CD |
|---|---|---|
master |
Production | Deploy to App Store + Play Store |
develop |
Staging | Deploy to internal tracks |
feature/* |
New features | Analyze + test |
fix/* |
Bug fixes | Analyze + test |
release/* |
Release stabilization | Full test suite |
hotfix/* |
Urgent fixes | Analyze + test |
Development Setup
Prerequisites: Flutter 3.38+ (managed via FVM)
dart pub global activate fvm
fvm install && fvm use
flutter pub get
dart run build_runner build --delete-conflicting-outputs
flutter test
Roadmap
Completed Features
- Basic health record management
- Authentication and security
- Cross-platform support
- File import & in-app viewing
- Smart document scanning (AI reads and organizes your medical records)
- Add IPS (International Patient Summary) to Google / Apple Wallet
- Cross-platform proximity sharing — works between iOS and Android, view-only on receiver, no data saved, screenshots blocked
In Progress
- Desktop app with backup sync and offloaded document processing
Future Plans
- Responsive UI
- Wearable & health provider integration
- AI health insights
- AI Note taking prescription
- Family management
- QR code sharing (SMART Health Cards)
Contributing
We welcome contributions! See CONTRIBUTING.md for guidelines.
# Fork → Branch → Code → PR
git checkout -b feature/your-feature
# Make changes
git push origin feature/your-feature
# Open a pull request
Sponsors
HealthWallet.me is an open-source project dedicated to improving healthcare accessibility and patient data management.
Interested in corporate sponsorship or partnership opportunities? We offer:
- Enterprise features and custom integrations
- White-label solutions for healthcare organizations
- Strategic partnerships in the healthcare technology space
- Priority support and dedicated resources
Authors
- Alex Szilagyi — @alexszilagyi
- Jason Kulatunga — @AnalogJ
License
GPL-3.0 — © Copyright 2026, Life Value