oksome / intercom Goto Github PK

A daemon and it's minions used for managing you Home. They communicate using ZeroMQ and are built in Python 3.

Intercom is made out of five different kinds of components :

• broker : central communication node, relays messages between other components
• minions : execute instructions
• controllers : send instructions from user interactions
• monitors : read sensors and publish their values
• logic nodes : transform information into instructions

All you need Python 3.2 or greater, ZeroMQ and PyZMQ.

pip install intercom

By default, minions will expect the broker to be available on the host intercom. Edit your DNS settings or the hosts file of the systems on which you will run minions to resolve to the machine running the broker.

python -m intercom.broker

You may want to run the broker in a screen session or using supervisord.

python myminion.py

You will find example of minions in Intercom/intercom/minions/.

The following Minion will just print a text on the terminal:

from intercom.minion import Minion

minion = Minion('minion.pc')

@minion.register('do:test.print')
def test_print(topic, msg):
    print('This is some text:')
    print(msg.get('text', ''))

if __name__ == '__main__':
    minion.run()