braubuddy 0.4.2

Description:

braubuddy 0.4.2

Braubuddy is a temperature management framework written in Python.
Conceived as a means of monitoring and controlling the fermentation temperature of beer, Braubuddy can be used in any situation where visibility and/or control of temperature is critical:

Keep tropical fish swimming happily in water that’s 26°C
Brew a perfect lager by fermenting at a constant 9°C
Maximise employee productivity with an optimum office ambient air temp of 21.5°C

Complete documentation is available at braubuddy.org.

Features

Web Interface
Braubuddy’s web interface facilitates temperature monitoring from any device with a web browser.



API
Time-series temperature, heating and cooling metrics may be consumed programatically using the Braubuddy API.


Outputs
Braubuddy outputs allow metric values to be recorded in a variety of formats or published directly to external services including Graphite, Librato, Dweet and Twitter.


Extensible
The various Braubuddy components are designed to be extended. Consult CONTRIBUTE.RST if you’d like to request or contribute support for a particular component.



Getting Started

Hardware
To monitor temperature using Braubuddy you will need a supported thermometer.
To control temperature you will also need a supported environmental controller.


Install
Braubuddy is best enjoyed from within a Python virtualenv:
virtualenv ~/braubuddy
source ~/braubuddy/bin/activate

Production
Install the latest production release from PyPI <https://pypi.python.org/>:
pip install braubuddy


Development
Install the latest development release from Github:
git clone https://github.com/amorphic/braubuddy.git
pip install -e ./braubuddy



Start
Start braubuddy with a single command:
braubuddy


Configure
If not already present, a default configuration file is deployed to ~/.config/braubuddy/.
For system-wide configuration, copy this config file to /etc/xdg/braubuddy/.
The example config file use default targets and automatically attempts to find a compatible thermometer and environmental controller. Follow the docs to customise your configuration.