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.

Braubuddy's web interface facilitates temperature monitoring from any device with a web browser.

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

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.

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.

To monitor temperature using Braubuddy you will need a supported thermometer.

To control temperature you will also need a supported environmental controller.

Braubuddy is best enjoyed from within a Python virtualenv:

virtualenv ~/braubuddy
source ~/braubuddy/bin/activate

Install the latest production release from `PyPI <https://pypi.python.org/>`:

pip install braubuddy

Install the latest development release from Github:

git clone https://github.com/amorphic/braubuddy.git
pip install -e ./braubuddy

Start braubuddy with a single command:

braubuddy

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.