https://github.com/lifevalue/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.
https://github.com/lifevalue/healthwallet.me
ai dart digital-health ehr emr fhir flutter health healthcare llama-cpp llm medical-records mobile-health offline-first on-device-ai open-source patient-data personal-health-record privacy self-hosted
Last synced: about 1 month ago
JSON representation
Open-source, patient-controlled health record app with on-device AI. Aggregates medical data from 52K+ providers via FHIR R4. Offline-first. Flutter.
- Host: GitHub
- URL: https://github.com/lifevalue/healthwallet.me
- Owner: LifeValue
- License: gpl-3.0
- Created: 2025-09-15T20:49:54.000Z (9 months ago)
- Default Branch: master
- Last Pushed: 2026-04-16T14:37:22.000Z (about 1 month ago)
- Last Synced: 2026-04-16T16:36:40.671Z (about 1 month ago)
- Topics: ai, dart, digital-health, ehr, emr, fhir, flutter, health, healthcare, llama-cpp, llm, medical-records, mobile-health, offline-first, on-device-ai, open-source, patient-data, personal-health-record, privacy, self-hosted
- Language: Dart
- Homepage: https://healthwallet.me
- Size: 146 MB
- Stars: 60
- Watchers: 1
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# HealthWallet.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.**
[](https://apps.apple.com/app/healthwallet-me/id6748325588)
[](https://play.google.com/store/apps/details?id=com.techstackapps.healthwallet)
[](changelog.md)
[](LICENSE.md)
[](https://flutter.dev)
[](https://hl7.org/fhir/R4/)
[]()
[](https://github.com/lifevalue)
[](https://www.youtube.com/@TechStackAppsCo)
[](https://www.facebook.com/techstackapps/)
[](https://www.linkedin.com/company/lifevalue/)
[](https://x.com/techstackapps)
---
## 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](https://github.com/fastenhealth/fasten-onprem) 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
[](https://apps.apple.com/app/healthwallet-me/id6748325588)
[](https://play.google.com/store/apps/details?id=com.techstackapps.healthwallet)
### Set Up Your Self-Hosted Backend
The backend ([FastenHealth](https://github.com/fastenhealth/fasten-onprem)) aggregates medical records from healthcare providers and syncs them to your phone.
**Prerequisites:** [Docker](https://docs.docker.com/get-docker/)
```bash
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
1. Generate an access token in your FastenHealth dashboard
2. Scan the QR code with HealthWallet
3. Your records sync automatically
---
## On-Device AI — How It Works
HealthWallet runs a quantized LLM directly on your phone using [llama.cpp](https://github.com/ggerganov/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](https://huggingface.co/Qwen/Qwen3-VL-2B-Instruct-GGUF)) | ~1.1 GB | Fast, lightweight, works on most devices |
| **Advanced** ([MedGemma-4B](https://huggingface.co/SandLogicTechnologies/MedGemma-4B-IT-GGUF)) | ~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](https://fvm.app/))
```bash
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](CONTRIBUTING.md) for guidelines.
```bash
# 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
[**Contact us**](https://lifevalue.com/company/contact)
---
## Authors
- **Alex Szilagyi** — [@alexszilagyi](https://github.com/alexszilagyi)
- **Jason Kulatunga** — [@AnalogJ](https://github.com/AnalogJ)
## License
[GPL-3.0](LICENSE.md) — © Copyright 2026, Life Value
---
**If HealthWallet helps you, give it a star** — it helps others find it too.
[](https://apps.apple.com/app/healthwallet-me/id6748325588)
[](https://play.google.com/store/apps/details?id=com.techstackapps.healthwallet)