Skip to main content

Commandline tools for the homebrewer

Project description


╔╗ ╦═╗╔═╗╦ ╦  ╔╦╗╔═╗╔═╗╦  ╔═╗
╠╩╗╠╦╝║╣ ║║║───║ ║ ║║ ║║  ╚═╗
╚═╝╩╚═╚═╝╚╩╝   ╩ ╚═╝╚═╝╩═╝╚═╝

Build Status Documentation Status PyPI version

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

NOTE: All values and calculations are provided as guidelines only. Brew-tools should not be used for professional brewing. No warranty or guarantee of accuracy is provided on the information provided by this calculator.


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

  • Adjust gravity with dme calculator

  • Apparent and Real attenuation calculator

  • Final gravity from a given attenuation percentage

  • Gravity adjustment by boil off/dilution calculator

  • New gravity after volume adjustment

  • Strike water temperature

  • Unit conversion

More to come

See the changelog for updates in each version


Brew-tools is available from PyPI

pip install brew-tools

You can also clone/download this repository and install it using pip

cd <brew-tools-dir>
pip install .


When first starting Brew tools you will be asked for your preferred unit type, metric or imperial. This is then stored in a config file and used as the default unit. This can be temporarily changed with the –unit option.

Brew tools has built in help

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

--version  Show the version and exit.
--unit [metric|imperial]  Ignore config and use a different unit.
--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. The current version of brew-tools uses [Poetry]( to manage virtual environments and such.

In order to start, [install Poetry]( and change into the brew-tools directory. From there you can run

poetry install

which will create a virtual environment and install the dependencies. To run brew_tools in the developmeent environment it’s probably easiest to run

poetry shell

which will spawn a configured shell for the environment.

Tests can be run in this environment, or you can use

poetry run pytest tests

to run the tests without spawning a shell.

In addition to the tests it’s advisable to run a linter of the source as Travis will also check for linting errors. The linter command ignores some errors, so you can use this command to match the command run by Travis

poetry run flake8 src --ignore=E501,W504,W503


Thanks to

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

  • SlayterDev - DME addition calculator


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.3.0.tar.gz (13.7 kB view hashes)

Uploaded Source

Built Distribution

brew_tools-0.3.0-py3-none-any.whl (13.5 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page