HealthWallet.me
Open-source, patient-controlled health record app with on-device AI. Aggregates medical data from 52K+ providers via FHIR R4. Offline-first. Flutter.
Install / Use
/learn @LifeValue/HealthWallet.meREADME
HealthWallet.me
<div align="center"> <img src="assets/readme/icon_and_healthwallet.svg" alt="HealthWallet.me Logo" width="500">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
<div align="center">
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).
<details> <summary><strong>Device Requirements</strong></summary>| 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 |
</details>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) |
<details> <summary><strong>Project Structure</strong></summary>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 | 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
