Work-In-Progress

PLEASE NOTE THIS DOCUMENTATION IS STILL BEING WRITTEN BY OUR AWESOME COMMUNITY. UNTIL IT IS FINISHED, PLEASE DO NOT SET UP YOUR OPEN-iAPS BASED ON THIS DOCUMENTATION ALONE. CONTACT THE COMMUNITY ON DISCORD OR FACEBOOK TO MAKE SURE YOU GET IT RIGHT AND STAY SAFE

What is Open-iAPS?

Open-iAPS is an automated insulin delivery system for iOS based on the OpenAPS algorithm with adaptations for Open-iAPS.

The project started as Ivan Valkou’s FreeAPS X implementation of the OpenAPS algorithm for iPhone and later forked and rebranded as iAPS. Since then, many developers have contributed substantial work, leading to a range of new features and enhancements.

Following the release of version 3.0.0, the project’s direction significantly changed due to differing views on development, open source, and peer review. This led to the separation from the Artificial-Pancreas/iAPS repository and the birth of Open-iAPS as a distinct entity. This transition marks the project’s new phase, symbolizing its evolution and the collaborative development’s dynamic nature.

Open-iAPS continues to leverage a variety of frameworks from the DIY looping community and remains at the forefront of DIY diabetes management solutions, constantly evolving with valuable contributions from its community.

Before starting with Open-iAPS, you should evaluate all your closed-loop options, including:

  • Commercial systems such as Medtronic’s 780G, Tandem’s Control-IQ, or Insulet’s Omnipod 5

  • Other open-source applications like Loop and AndroidAPS

Warning

Open-iAPS is a DIY, open-source community project. It has not been evaluated by any regulatory agency and is for use at your own risk.

Getting Started

Before starting with Open-iAPS, you should understand carb ratio (CR), insulin sensitivity factor (ISF), and basal rates. If you have read the documentation and still require help identifying your settings, please seek advice from your healthcare provider.

To use Open-iAPS, you are required to build the application from the source code. This does not require substantial technical know-how but is a time-consuming process. You may need several sessions to complete your first build.

Upon installation, you will need to configure your settings appropriately. By default Open-iAPS acts no differently than your pump, with the exception that it may recommend temporary basals from time to time. The magic happens by turning on “Closed Loop”, enabling Super Micro Bolus (SMB) features, and turning on dynamic features.

In general, these are the first three settings you will want to configure as you gain confidence in the app and your settings:

  • Enable Closed Loop for automation

  • Increase Max IOB to “average meal bolus + 3x max daily basal”

  • Enable SMB and UAM for automatic bolusing (ensure your ISF is optimized before enabling this) See Configure for more information on Open-iAPS configuration.

If you are considering a transition from another closed loop system, please read this section first.

Contribution

Open-iAPS is built by a volunteer community. If you are interested in helping as a programmer, you can contribute to the Open-iAPS or OpenAPS code base. Open-iAPS is mostly written in SwiftUI, and the OpenAPS algorithm is written in JS.

You can also provide support in online support groups by helping users adjust their settings and troubleshoot common errors.

Advanced Settings