Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

An extensile temperature management framework.

Project description

Braubuddy CI Downloads Supported Python versions

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.

Braubuddy web application

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.

Project details


Release history Release notifications

This version
History Node

0.4.2

History Node

0.4.1

History Node

0.4.0

History Node

0.3.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
braubuddy-0.4.2.tar.gz (237.2 kB) Copy SHA256 hash SHA256 Source None Nov 23, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page