• Easily navigatable version of the latest production docs are here.
• Easily navigatable version of the in-development or "dev" docs can be found here.

Welcome to the openaps documentation!

openaps is part of a set of tools to support a self-driven Do-It-Yourself (DIY) implementation of an artificial pancreas based on the OpenAPS reference design.

Here are two visuals to show you what the physical hardware components of an OpenAPS setup look like - version A is without labels; version B contains labels to describe the parts.

By proceeding to use these tools or any piece within, you agree to the copyright (see LICENSE.txt for more information) and release any contributors from liability.

The tools may be categorized as: 1) monitor collecting data and operational status from devices, and/or aggregating as much data as is relevant into one place; 2) predict make predictions about what will happen next; and 3) control enacting changes, and feeding more data back into the monitor, closing the loop.

This is a set of development tools to support a self-driven DIY implementation. Any person choosing to use these tools is solely responsible for testing and implementing these tools independently or together as a system.

The DIY part of OpenAPS is important. There are very good reasons why this isn't a single downloadable script. While formal training or experience as an engineer or a developer is not a prerequisite, a growth mindset is required to learn to work with the "building blocks" that will help you develop your OpenAPS instance. Remember as you consider this project that this is not a "set and forget" system; an OpenAPS implementation requires diligent and consistent testing and monitoring to ensure each piece of the system is monitoring, predicting, and controlling as desired. The performance and quality of your system lies solely with you.

This community of contributors believes in "paying it forward," and individuals who are implementing these tools are asked to contribute by asking questions, helping improve documentation, and contributing in other ways.

###OpenAPS System Development Phases

This documentation is organized into a series of phases that progressively build upon the openaps development tools towards a working OpenAPS system. The phases are as follows:

• Phase 0: General Setup
  Get the equipment you need; record baseline data, configure your hardware, install software, and become familiar with the openaps environment

• Phase 1: Logging, Cleaning, and Analyzing Your Data
  Create or utilize tools for logging and analyzing pump and CGM data

• Phase 2: Creating an Open Loop
  Use the logged data with oref0 tools to suggest insulin dose adjustments in an "open loop"; review and refine algorithms, test different scenarios for safety, prepare for creating a loop and implementing retry logic

• Phase 3: Understanding Your Open Loop
  Analyze the basal recommendations that are outputted from your system; run in a test environment for multiple days to configure safety settings that are right for you.

• Phase 4: Starting to Close the Loop
  Apply the recommendations automatically and in real time by creating a schedule and continuing to validate and assess outputs; beginning with a simple "low glucose suspend"-type mode for several days, tweaking settings and validating setup before moving forward.

• Phase 5: Tuning the Closed Loop
  Moving beyond low glucose suspend mode, work through tuning your targets

• Phase 6: Iterate and Improve the Closed Loop
  At the end of the previous stages and after 3 consecutive nights with no hardware failures and at least 1 night without low alarms, you can move into advanced features like meal-assist and auto-sensitivity tuning. Also improve the functionality of the system with additional software or hardware development

Below is an overview of all content linked inside of this document repository. You may also find this guide to getting started with openaps commands (not yet linked below) useful.

• Introduction
  • Understanding this guide
    • Before you get started
    • What you won’t see in this guide
  • Ways to Contribute
  • Where to go for help with your implementation
    • Gitter
    • Google Groups
    • Issues on openaps GitHub
    • Other online forums
• Walkthrough
  • Phase 0: General Setup
    • General Setup and Project Prep
    • Baseline data
    • Hardware
    • Setting Up Your Raspberry Pi
    • Setting Up openaps and Dependencies
  • Phase 1: Logging, Cleaning, and Analyzing Your Data
    • Phase 1: Logging, Cleaning, and Analyzing Your Data
    • Visualization and Monitoring
  • Phase 2: Build a Manual System
    • Phase 2: Creating an Open Loop
    • Configuring and Learning to Use openaps Tools
    • Building preflight and other safety checks
    • Add the oref0 Virtual Devices
    • Organizing the reports
    • The get-profile process
    • The calculate-iob process
    • The determine-basal process
    • Adding aliases
    • Checking your reports
    • Enacting the suggested action
    • Cleaning CGM data from Minimed CGM systems
    • Running an open loop with oref0
  • Phase 3: Automation
    • Phase 3: Understanding Your Open Loop
    • Understanding the output of oref0-determine-basal
  • Phase 4: Iterate and Improve
    • Phase 4: Starting to Close the Loop
    • Using cron to create a schedule for your loop
    • Observing the closed loop
    • Troubleshooting the closed loop
  • Phase 5: Tuning the Closed Loop
    • Phase 5: Tuning the Closed Loop
    • Going beyond low glucose suspend mode
    • Tuning your targets
  • Phase 6: Iterate and Improve the Closed Loop
    • Phase 6: Iterating on Your Closed Loop
    • So you think you’re looping? Now keep up to date!
    • Testing during the day
    • Usability Considerations
    • Advanced features
    • Configuring Automatic Sensitivity Mode
• Resources
  • Making your first PR (pull request)
  • Technical Resources
    • Raspberry Pi
    • Git and GitHub
    • Linux Shell / Terminal
    • Python
    • Useful Apps
    • Markdown & GitBook
  • Troubleshooting
    • Generally useful linux commands
    • Dealing with the CareLink USB Stick
    • Dealing with a corrupted git repository
    • Environment variables
    • Common error messages
  • OpenAPS Overview and Project History
  • Other People, Projects & Tools
    • People
    • APS & Diabetes Data Tools
  • Commercial APS Efforts
  • Frequently Asked Questions
    • What is a Closed Loop?
    • What does an OpenAPS closed loop look like?
  • Glossary