Skip to main content

REST-like IoT server

Project description

Igor, your personal IoT butler

Build Status Coverage Status Documentation status PyPI version

Igor is named after the Discworld characters of the same name. You should think of it as a butler (or valet, or majordomo, whatever the difference is) that knows everything that goes on in your household, and makes sure everything runs smoothly. It performs its tasks without passing judgements and maintains complete discretion, even within the household. It can work together with other Igors (lending a hand) and with lesser servants such as Iotsa-based devices.

Igor includes a Certificate Authority implementation that allows you to use secure communication over https on the local network (for Igor and for other applications like web browsers). Igor also includes a privacy and security mechanism based on capabilities to allow fine-grained control over data access.

Home page is This software is licensed under the MIT license by the CWI DIS group,


Igor is primarily an XML database. It has a REST interface to communicate to the outside world, and it can emit requests as well. It performs its tasks of managing your household by knowing three things:

  1. what is going on at the moment,
  2. what needs to happen when, and
  3. how to make that happen.

Igor has a plugin mechanism, and you can add plugins for all kinds of sensors (point 1). You can also add plugins that can control external devies (point 3). Finally you add rules to connect these (point 2).

Igor has a web interface to allow you to control and maintain it. It also comes with a number of useful plugins and a set of Python modules and command line utilities that interact with it.


Formatted documentation is available online, at

When viewing source documentation is also available here.

Getting Started

You need to have Python 3.6 or later installed. (Python 2.7 is also still supported but Python 3 is preferred).

You need the pip package manager for the version of Python that you are going to use.

python3 -m pip install igor-iot

After that follow the instructions in or doc/setup.rst to setup your Igor system.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for igor-iot, version 0.99.1
Filename, size File type Python version Upload date Hashes
Filename, size igor_iot-0.99.1-py3-none-any.whl (330.6 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size igor-iot-0.99.1.tar.gz (206.0 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page