search

cwi-dis / igor

Igor, an extensible home automation server.
MIT License
6 stars 2 forks source link
iot iot-middleware iotsa

readme

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 https://github.com/cwi-dis/igor. This software is licensed under the MIT license by the CWI DIS group, http://www.dis.cwi.nl.

Overview

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.

Documentation

Formatted documentation is available online, at https://igor-iot.readthedocs.io.

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 https://igor-iot.readthedocs.io/en/latest/setup.html or doc/setup.rst to setup your Igor system.