These are the core utilities needed to develop a self-built open source artificial pancreas.
This is part of a series of tools to support a self-driven DIY implementation based on the OpenAPS reference design. The tools may be categorized as monitor (collecting data about environment, and operational status of devices and/or aggregating as much data as is relevant into one place), predict (make predictions about what should happen next), or control (enacting changes, and feeding more data back into the monitor).
By proceeding using these tools or any piece within, you agree to the copyright (see LICENSE.txt for more information) and release any contributors from liability.
Check out the OpenAPS documentation to help get you started.
Note: This is intended to be a set of tools to support a self-driven DIY implementation and any person choosing to use these tools is solely responsible for testing and implement these tools independently or together as a system. The DIY part of OpenAPS is important. While formal training or experience as an engineer or a developer is not required, what is required is a growth mindset to learn what are essentially "building blocks" to implement an OpenAPS instance. This is not a "set and forget" system; it requires diligent and consistent testing and monitoring to ensure each piece of the system is monitoring, predicting, and performing as desired. The performance and quality of your system lies solely with you.
Additionally, 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 contribute in other ways.
This is not an artificial pancreas, but rather tools which independently allow:
-
monitor - Collect data about environment, and operational status of devices. Aggregate as much data relevant to therapy as possible into one place. We propose a tool,
openaps-use
as a proof of concept. -
predict - Can make predictions about what should happen next.
-
control - Can enact changes in the world: emails, placing phone calls, SMS, issuing commands to pumps.
There are two ways to install openaps, from source, and as a python package via setuptools.
The following apt-get dependencies are required (they can be installed through variety of means, in debian/ubuntu and apt based systems the following packages are recommended/required:
sudo apt-get install python python-dev python-setuptools python-software-properties python-numpy
To install from source clone this repo, and issue:
sudo python setup.py develop
sudo pip install -U openaps
This installs openaps
system wide.
Do not use openaps
commands in the the openaps repo. Only use the
openaps
directory for hacking on the core library, or for managing
upgrades through git. Running openaps
inside of the openaps
source directory will error in the best case, and mess up your
openaps
install in the worst case.
sudo easy_install -ZU openaps
usage: openaps [-h] [-c C C] [-C CONFIG] [--version] [command] ...
- command
- args
optional arguments:
-h, --help show this help message and exit
-c C C
-C CONFIG, --config CONFIG
--version show program's version number and exit
Utilities for developing an artificial pancreas system. openaps helps you manage and structure reports for various devices.
All of the device
and report
add
and show
commands modify
openaps.ini
in the current working directory, which is assumed to be
a git repo explicit