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.

Source Distribution

igor-iot-0.99.1.tar.gz (206.0 kB view hashes)

Uploaded source

Built Distribution

igor_iot-0.99.1-py3-none-any.whl (330.6 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page