Fasten is an open-source, self-hosted, personal/family electronic medical record aggregator, designed to integrate with 100,000's of insurances/hospitals/clinics
Go to file
Jason Kulatunga 2c5133bef7 adding testing framework for Aggregation code.
WIP.
2023-08-14 17:23:36 -06:00
.github/workflows fixing event type for `latest` docker image tag. 2023-08-09 11:49:58 -07:00
.idea make sure reference fields are correctly extracted and stored in the DB. 2023-08-13 15:28:03 -06:00
backend adding testing framework for Aggregation code. 2023-08-14 17:23:36 -06:00
frontend adding testing framework for Aggregation code. 2023-08-14 17:23:36 -06:00
.dockerignore Use Depot for Docker builds (#55) 2023-01-31 18:30:55 -08:00
.gitattributes fixing linguist 2022-10-13 23:57:36 -07:00
.gitignore update gitignore file to exclude DB snapshots. 2023-08-09 11:51:36 -07:00
CONTRIBUTING.md update makefile 2023-05-14 13:43:23 -04:00
Dockerfile fix docker image build again. 2023-07-14 20:43:57 -07:00
LICENSE.md updating license -- GPLv3 2022-10-12 19:11:12 -07:00
Makefile Widget Dashboard Queries using extracted Search Parameters (#179) 2023-07-08 07:43:30 -07:00
README.md Storybook Integration for Component testing. (#142) 2023-05-05 09:06:33 -07:00
TODO.md UI Tweaks (#32) 2023-01-15 10:25:46 -08:00
config.yaml fixing config file -- correct database mount location. 2023-01-26 03:10:36 -08:00
docker-compose.yml Working nextgen api. 2023-03-09 17:35:33 -08:00
go.mod bump fasten-sources version (includes Immunization extraction fixes) 2023-08-13 14:15:52 -06:00
go.sum bump fasten-sources version (includes Immunization extraction fixes) 2023-08-13 14:15:52 -06:00
packagr.yml comment out the packagr nodejs addl file. 2022-12-18 22:31:18 -08:00

README.md

fasten_view

Fasten - On Premise/Self-Hosted

CI codecov GitHub license GitHub release (latest by date) Discord Join Request Providers Join Mailing List GitHub Sponsors

Fasten securely connects your healthcare providers together, creating a personal health record that never leaves your hands

NOTE: Fasten is a Work-in-Progress and can only communicate with a limited number of Healthcare Instutions (approx 10,000 at last count). Please fill out this Google Form if you'd like to be kept up-to-date on Fasten

Introduction

Like many of you, I've worked for many companies over my career. In that time, I've had multiple health, vision and dental insurance providers, and visited many different clinics, hospitals and labs to get procedures & tests done.

Recently I had a semi-serious medical issue, and I realized that my medical history (and the medical history of my family members) is a lot more complicated than I realized and distributed across the many healthcare providers I've used over the years. I wanted a single (private) location to store our medical records, and I just couldn't find any software that worked as I'd like:

  • self-hosted/offline - this is my medical history, I'm not willing to give it to some random multi-national corporation to data-mine and sell
  • It should aggregate my data from multiple healthcare providers (insurance companies, hospital networks, clinics, labs) across multiple industries (vision, dental, medical) -- all in one dashboard
  • automatic - it should pull my EMR (electronic medical record) directly from my insurance provider/clinic/hospital network - I dont want to scan/OCR physical documents (unless I have to)
  • open source - the code should be available for contributions & auditing

So, I built it

Fasten is an open-source, self-hosted, personal/family electronic medical record aggregator, designed to integrate with 1000's of insurances/hospitals/clinics

Here's a couple of screenshots that'll give you an idea of what it looks like:

fasten_view
See more Fasten screenshots

Features

It's pretty basic right now, but it's designed with a easily extensible core around a solid foundation:

  • Self-hosted
  • Designed for families, not Clinics (unlike OpenEMR and other popular EMR systems)
  • Supports the Medical industry's (semi-standard) FHIR protocol
  • Uses OAuth2 (Smart-on-FHIR) authentication (no passwords necessary)
  • Uses OAuth's offline_access scope (where possible) to automatically pull changes/updates
  • Multi-user support for household/family use
  • (Future) Dashboards & tracking for diagnostic tests
  • (Future) Integration with smart-devices & wearables

Getting Started

There are 2 flavors of Fasten:

  • ghcr.io/fastenhealth/fasten-onprem:sandbox - This version only allows you to connect to a handful of Healthcare providers, using Sandbox accounts that are meant for testing, and contain synthetic(fake) data to give you an idea what Fasten will look like, without requiring personal medical information.
  • ghcr.io/fastenhealth/fasten-onprem:main - This version allows you to connect to 650+ different Healthcare providers, using your existing accounts. It will allow you to connect and retrieve your personal electronic medical record and store it within Fasten. Be careful, this is YOUR health data

Instructions

Run the following commands to download and start the Fasten docker container.

docker pull ghcr.io/fastenhealth/fasten-onprem:main 
docker run --rm -p 9090:8080 ghcr.io/fastenhealth/fasten-onprem:main 

Next, open a browser to http://localhost:9090

At this point you'll be redirected to the login page.

Logging In

Before you can use the Fasten BETA, you'll need to Create an Account.

It can be as simple as

  • Username: testuser
  • Password: testuser

Usage

If you're using the sandbox version of Fasten, you'll only be able to connect to Sources using test credentials https://github.com/fastenhealth/docs/blob/main/BETA.md#connecting-a-new-source

FAQ's

See FAQs for common questions (& answers) regarding Fasten

Contributing

Please see the CONTRIBUTING.md for instructions for how to develop and contribute to the Fasten codebase.

Work your magic and then submit a pull request. We love pull requests!

If you find the documentation lacking, help us out and update this README.md. If you don't have the time to work on Fasten, but found something we should know about, please submit an issue.

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

Authors

Jason Kulatunga - Initial Development - @AnalogJ

Licenses

  • GPLv3

Sponsors

Fasten is only possible with the help of my Github Sponsors and Reddit supporters!

I'd also like to thank the following Corporate Sponsors: