MyCoffee is a command-line tool for coffee enthusiasts who love brewing with precision. It helps you calculate the perfect coffee-to-water ratio for various brewing methods, ensuring you brew your ideal cup every time-right from your terminal.
| PyPI Counter | |
| Github Stars |
| Branch | main | dev |
| CI |
| Code Quality |
- Download Version 2.1 or Latest Source
pip install .
- Check Python Packaging User Guide
pip install mycoffee==2.1
ℹ️ You can use mycoffee or python -m mycoffee to run this program
> mycoffee --version
2.1> mycoffee --info
__ __ ____ __ __
| \/ | _ _ / ___| ___ / _| / _| ___ ___
| |\/| || | | || | / _ \ | |_ | |_ / _ \ / _ \
| | | || |_| || |___ | (_) || _|| _|| __/| __/
|_| |_| \__, | \____| \___/ |_| |_| \___| \___|
|___/
__ __ ____ _
\ \ / / _ |___ \ / |
\ \ / / (_) __) | | |
\ V / _ / __/ _ | |
\_/ (_)|_____|(_)|_|
MyCoffee is a command-line tool for coffee enthusiasts who love brewing with precision.
It helps you calculate the perfect coffee-to-water ratio for various brewing methods,
ensuring you brew your ideal cup every time-right from your terminal.
Repo : https://github.com/sepandhaghighi/mycoffee> mycoffee --method=v60
__ __ _ _ ___ _____ ____ ____ ____ ____
( \/ )( \/ ) / __)( _ )( ___)( ___)( ___)( ___)
) ( \ / ( (__ )(_)( )__) )__) )__) )__)
(_/\/\_) (__) \___)(_____)(__) (__) (____)(____)
Date: 2025-09-10 17:56
Mode: Water --> Coffee
Method: `v60`
Cups: 1
Coffee:
- Cup: 15 g
- Total: 15 g
Water:
- Cup: 250 g
- Total: 250 g
Ratio: 3/50 (0.06)
Strength: Medium
Grind: 550 um (Medium-Fine)
Temperature: 91 C
Message: V60 method- Methods List
mycoffee --methods-list
> mycoffee --method=v60 --mode="water-to-coffee" --water=300
__ __ _ _ ___ _____ ____ ____ ____ ____
( \/ )( \/ ) / __)( _ )( ___)( ___)( ___)( ___)
) ( \ / ( (__ )(_)( )__) )__) )__) )__)
(_/\/\_) (__) \___)(_____)(__) (__) (____)(____)
Date: 2025-09-10 17:56
Mode: Water --> Coffee
Method: `v60`
Cups: 1
Coffee:
- Cup: 18 g
- Total: 18 g
Water:
- Cup: 300 g
- Total: 300 g
Ratio: 3/50 (0.06)
Strength: Medium
Grind: 550 um (Medium-Fine)
Temperature: 91 C
Message: V60 method> mycoffee --method=v60 --mode="coffee-to-water" --coffee=12
__ __ _ _ ___ _____ ____ ____ ____ ____
( \/ )( \/ ) / __)( _ )( ___)( ___)( ___)( ___)
) ( \ / ( (__ )(_)( )__) )__) )__) )__)
(_/\/\_) (__) \___)(_____)(__) (__) (____)(____)
Date: 2025-09-10 17:56
Mode: Coffee --> Water
Method: `v60`
Cups: 1
Coffee:
- Cup: 12 g
- Total: 12 g
Water:
- Cup: 200 g
- Total: 200 g
Ratio: 3/50 (0.06)
Strength: Medium
Grind: 550 um (Medium-Fine)
Temperature: 91 C
Message: V60 method> mycoffee --method=v60 --mode="ratio" --coffee=18 --water=300
__ __ _ _ ___ _____ ____ ____ ____ ____
( \/ )( \/ ) / __)( _ )( ___)( ___)( ___)( ___)
) ( \ / ( (__ )(_)( )__) )__) )__) )__)
(_/\/\_) (__) \___)(_____)(__) (__) (____)(____)
Date: 2025-09-10 17:56
Mode: Water & Coffee --> Ratio
Method: `v60`
Cups: 1
Coffee:
- Cup: 18 g
- Total: 18 g
Water:
- Cup: 300 g
- Total: 300 g
Ratio: 3/50 (0.06)
Strength: Medium
Grind: 550 um (Medium-Fine)
Temperature: 91 C
Message: V60 methodℹ️ You can run mycoffee --coffee-units-list to view the supported coffee units
ℹ️ You can run mycoffee --water-units-list to view the supported water units
> mycoffee --method=chemex --water=20 --cups=3 --coffee-ratio=2 --water-ratio=37 --coffee-unit="t oz" --water-unit="fl oz" --grind=750 --temperature=88
__ __ _ _ ___ _____ ____ ____ ____ ____
( \/ )( \/ ) / __)( _ )( ___)( ___)( ___)( ___)
) ( \ / ( (__ )(_)( )__) )__) )__) )__)
(_/\/\_) (__) \___)(_____)(__) (__) (____)(____)
Date: 2025-09-10 17:56
Mode: Water --> Coffee
Method: `chemex`
Cups: 3
Coffee:
- Cup: 1.028 t oz
- Total: 3.084 t oz
Water:
- Cup: 20 fl oz
- Total: 60 fl oz
Ratio: 2/37 (0.054)
Strength: Medium
Grind: 750 um (Medium)
Temperature: 88 C
Message: Chemex methodℹ️ File format valid choices: [text, json, yaml]
ℹ️ The default file format is text
> mycoffee --method=chemex --water=20 --cups=3 --coffee-ratio=2 --water-ratio=37 --save-path="profile1.txt" --save-format="text"| Parameter | Description | Type | Default |
|---|---|---|---|
--mode |
Specifies the conversion mode | String | water-to-coffee |
--method |
Specifies the coffee brewing method | String | custom |
--water |
Sets the amount of water in each cup | Positive float | 240 |
--coffee |
Sets the amount of coffee in each cup | Positive float | 14.118 |
--cups |
Indicates the number of cups | Positive integer | 1 |
--grind |
Grind size (um) | Positive integer | 700 |
--temperature |
Brewing temperature | Float | 90 |
--coffee-ratio |
Coefficient for the coffee component in the ratio | Positive float | 1 |
--water-ratio |
Coefficient for the water component in the ratio | Positive float | 17 |
--message |
Extra information about the brewing method | String | Custom brewing method |
--digits |
Number of digits up to which the result is rounded | Integer | 3 |
--coffee-unit |
Coffee unit | String | g |
--water-unit |
Water unit | String | g |
--temperature-unit |
Temperature unit | String | C |
--save-path |
File path to save the output | String | -- |
--save-format |
Format to save the output | String | text |
Just fill an issue and describe it. We'll check it ASAP!
- Please complete the issue template
1- Coffee to water ratio calculator
2- V60 Brew Guide
3- How to Brew Coffee with a Chemex
4- Using French press for perfect coffee
5- How to Brew the Perfect Cup of Siphon Coffee
6- Using Espresso Brew Ratios
7- My Best Coffee Recipes of 2022
8- Auto Drip Brewing Guide
9- Guide To Cold Brew
10- Cold Brew Concentrate Recipe
11- How to Make Coffee in a Moka Pot
12- How to Make Turkish Coffee at Home
13- How to Cup Coffee
14- Tetsu Kasuya AeroPress Recipe
15- All about the intervals
16- Clever Dripper; Square Mile Coffee
17- AeroPress Product User Manuals
18- RapidTables - Weight Converter
19- Whole bean to ground coffee calculator
20- Weight to Volume Converter for Recipes
21- How Much Coffee per Cup?
22- Weight Calculator
23- Volume Conversion Calculator - Inch Calculator
24- Metric Conversion Charts and Calculators
25- Coffee grind size chart
26- The best temperature to brew coffee
27- How to Brew Coffee with a Syphon
28- Guide To Home Coffee Makers
29- Can you brew coffee with warm water?
30- How to Brew Coffee Using a Cezve
31- Coffee cupping
32- The Latest Method to Brew Coffee with Your Clever Dripper
33- How to Make Vietnamese Coffee with Traditional Phin Drip Filter
34- Kalita Wave 185 Brew Guide
35- How to Make the Perfect Instant Coffee, Hot or Iced
36- How to make the perfect coffee
Give a ⭐️ if this project helped you!
1KtNLEEeUbTEK9PdN6Ya3ZAKXaqoKUuxCy 0xcD4Db18B6664A9662123D4307B074aE968535388 Ldnz5gMcEeV8BAdsyf8FstWDC6uyYR6pgZ DDUnKpFQbBqLpFVZ9DfuVysBdr249HxVDh TCZxzPZLcJHr2qR3uPUB1tXB6L3FDSSAx7 rN7ZuRG7HDGHR5nof8nu5LrsbmSB61V1qq bnb1zglwcf0ac3d0s2f6ck5kgwvcru4tlctt4p5qef 0xcD4Db18B6664A9662123D4307B074aE968535388 Xd3Yn2qZJ7VE8nbKw2fS98aLxR5M6WUU3s GALPOLPISRHIYHLQER2TLJRGUSZH52RYDK6C3HIU4PSMNAV65Q36EGNL zil1knmz8zj88cf0exr2ry7nav9elehxfcgqu3c5e5