Skip to main content

Commandline tools for the homebrewer

Project description


 ____  ____  ____  _  _    ____  __    __   __    ____
(  _ \(  _ \(  __)/ )( \  (_  _)/  \  /  \ (  )  / ___)
 ) _ ( )   / ) _) \ /\ /    )( (  O )(  O )/ (_/\\___ \
(____/(__\_)(____)(_/\_)   (__) \__/  \__/ \____/(____/

Build Status Documentation Status

A command line utility that offers a set of calculators for home brewers.


Need to do a quick calculation during your brew day? Don’t fancy digging through a GUI application, or a web based tool? Prefer to do simple things in a terminal?

Then brew-tools is for you.

Currently brew-tools includes:

  • ABV calculator

  • Keg priming calculator

  • Priming sugar calculator

  • Quick infusion calculator

More to come


Currently there is no PyPI package for brewtools, but you can clone/download this repository and install it using pip

cd <brew-tools-dir>
pip install .


Brew tools has built in help

Usage: brew-tools [OPTIONS] COMMAND [ARGS]...

--version  Show the version and exit.
-imperial  Use imperial units. Metric by default.
--help     Show this message and exit.


and also for its commands

brew-tools infuse --help
Usage: brew-tools infuse [OPTIONS]

  -temp FLOAT    Current temperature of mash
  -target FLOAT  Target temperature of mash
  -ratio FLOAT   Grist/water ratio
  -grain FLOAT   Weight of grain in mash
  -water FLOAT   Temp of infusion water
  --help         Show this message and exit.

If the inputs are not passed via the command line arguments, brew tools will prompt the user for input.

For more information see the documentation


If you want to help develop brew tools you should install it into a virtual environment.

Create and source the environment and then install brew tools with

cd <brew-tools project dir>
pip install -e ".[testing]"

which will install an editable version, as well as all the tools required to run the tests with

pytest tests


Thanks to

  • /u/DAMNIT_REZNO - for inspiring me to start this project


Brew Tools is released under the MIT license.

See LICENSE.txt for more details

Project details

Download files

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

Source Distribution

brew-tools-0.0.4.tar.gz (17.9 kB view hashes)

Uploaded source

Built Distribution

brew_tools-0.0.4-py2.py3-none-any.whl (7.9 kB view hashes)

Uploaded py2 py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page