Installing openaps

The recommended way to install openaps is to use python’s package management system. The openaps project is distributed on pypi. 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 required:

sudo apt-get install python python-dev python-pip python-software-properties python-numpy
sudo pip install setuptools

From pypi

To install from pypi:

sudo easy_install -Z openaps

This installs openaps system wide.


To update openaps, append the -U option:

sudo easy_install -ZU openaps

From source

Sometimes, it’s useful to use a development version to help test or debug features. Here’s how to install the project from source.

git clone git://
cd openaps
# checkout desired branch (dev)?
git checkout dev
sudo python develop

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.