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.
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.
| 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 |
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 -dThen open http://localhost:9090, create an account, and you're ready.
- Generate an access token in your FastenHealth dashboard
- Scan the QR code with HealthWallet
- Your records sync automatically
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.
| 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 |
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 |
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- 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
- Desktop app with backup sync and offloaded document processing
- Responsive UI
- Wearable & health provider integration
- AI health insights
- AI Note taking prescription
- Family management
- QR code sharing (SMART Health Cards)
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 requestHealthWallet.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
- Alex Szilagyi — @alexszilagyi
- Jason Kulatunga — @AnalogJ
GPL-3.0 — © Copyright 2026, Life Value
If HealthWallet helps you, give it a star — it helps others find it too.
