drinkfyi 0.1.2

Unified beverage knowledge hub — cocktails, wine, beer, whiskey, tea, coffee, and sake in one package.

drinkfyi

Unified beverage knowledge hub for Python. Access cocktails, wine, beer, whiskey, tea, coffee, and sake through a single package. DrinkFYI aggregates 7 specialized beverage APIs into one unified interface -- search across 636 cocktail recipes, 777 grape varieties, 112 beer styles, 80 whiskey expressions, 60 tea varieties, 72 coffee varieties, and 80 sake expressions. Part of the FYIPedia developer tools ecosystem.

Explore beverages -- CocktailFYI | VinoFYI | BeerFYI | BrewFYI | WhiskeyFYI | TeaFYI | NihonshuFYI

Table of Contents

• Install
• Available Packages
• Quick Start
• What You'll Find Across the Beverage FYI Family
  • Cocktails (CocktailFYI)
  • Wine (VinoFYI)
  • Beer (BeerFYI)
  • Coffee (BrewFYI)
  • Whiskey (WhiskeyFYI)
  • Tea (TeaFYI)
  • Sake (NihonshuFYI)
• Command-Line Interface
• API Endpoints
• Using Individual Packages
• Learn More About Beverages
• Beverage FYI Family
• License

Install

pip install drinkfyi[all]            # Everything (7 beverage packages + CLI)
pip install drinkfyi[cocktail]       # Cocktail engine only
pip install drinkfyi[wine,beer]      # Wine + beer clients
pip install drinkfyi[cli]            # CLI only (no beverage packages)

Available Packages

Install only the beverage categories you need:

Extra	Package	Site	Data
cocktail	cocktailfyi	cocktailfyi.com	636 recipes, 15 families, ABV/calorie engine
wine	vinofyi	vinofyi.com	777 grapes, regions, wineries, 741K records
beer	beerfyi	beerfyi.com	112 styles, 82 hops, 41 malts, 29 yeast
coffee	brewfyi	brewfyi.com	72 varieties, 20 origins, 21 brew methods
whiskey	whiskeyfyi	whiskeyfyi.com	80 expressions, 13 regions, 7 countries
tea	teafyi	teafyi.com	60 varieties, 15 teaware, 7 categories
sake	nihonshufyi	nihonshufyi.com	80 sake, 10 rice varieties, 50 breweries

Quick Start

from drinkfyi import available_clients, get_client

# See what's installed
print(available_clients())  # ['cocktail', 'wine', 'beer', ...]

# Get a client by type
client = get_client("cocktail")
results = client.search("margarita")
client.close()

# Or use individual packages directly
from cocktailfyi import parse_measure_ml
ml = parse_measure_ml("1 1/2 oz")  # 45.0

What You'll Find Across the Beverage FYI Family

The Beverage FYI Family spans 7 specialized sites covering the world's major drink categories. Each site provides structured data through a consistent API pattern -- free, no authentication required, JSON with CORS enabled.

Cocktails (CocktailFYI)

CocktailFYI covers 636 cocktail recipes across 15 families (Sour, Daisy, Fizz, Collins, Highball, Old-Fashioned, Martini, Manhattan, Negroni, Flip, Julep, Toddy, Punch, Tiki, Shooter). Each recipe includes precise measurements, calculated ABV, estimated calories, flavor profiles, required glassware, and garnish specifications. The cocktailfyi package includes a local computation engine for ABV and calorie calculations without API calls.

Learn more: Cocktail Ingredient Guide

Wine (VinoFYI)

VinoFYI catalogs wines across 6 types (Red, White, Rose, Sparkling, Fortified, Dessert) with 777 grape varieties, wine regions organized by appellation system, wineries, and 230 expert guides. The database contains 741K records covering terroir characteristics, food pairings, and vintage information.

Learn more: Browse 777 Grape Varieties

Beer (BeerFYI)

BeerFYI follows the BJCP (Beer Judge Certification Program) style guidelines with 112 beer styles, 82 hop varieties with alpha acid profiles, 41 malts with SRM color values, and 29 yeast strains. Each style includes defined parameters for IBU, SRM, ABV, OG/FG ranges, and recommended ingredients.

Learn more: Browse 112 Beer Styles · Hop Variety Profiles

Coffee (BrewFYI)

BrewFYI covers 72 coffee varieties with genetic lineage (Arabica, Robusta, and hybrids), 20 origin countries with altitude and harvest data, and 21 brew methods with optimal extraction parameters. Guides cover processing methods (washed, natural, honey, anaerobic), roast profiling, and SCA cupping protocols.

Learn more: 21 Brew Methods

Whiskey (WhiskeyFYI)

WhiskeyFYI spans 80 whiskey expressions across 7 countries (Scotland, USA, Ireland, Japan, Canada, India, Taiwan) and 13 regions. Each expression includes type classification, cask information, age statement, ABV, and detailed tasting notes. The database covers legal definitions for Scotch, Bourbon, Tennessee, Rye, and Japanese whisky.

Learn more: Browse Whiskey Types · Explore 13 Whiskey Regions

Tea (TeaFYI)

TeaFYI covers 60 tea varieties organized by oxidation level across 7 categories (Green, White, Yellow, Oolong, Black, Pu-erh, Herbal), 15 origin countries, and 15 teaware items. Each tea includes processing method, caffeine content, optimal brewing parameters (temperature, steep time, leaf ratio), and flavor descriptors.

Learn more: Browse Tea Categories · Teaware Guide

Sake (NihonshuFYI)

NihonshuFYI catalogs 80 sake expressions with the tokutei meishoshu (special designation) classification system, 10 sake-specific rice varieties with shinpaku characteristics, and 50 breweries across Japan. Each sake includes grade, polishing ratio (seimaibuai), SMV (nihonshu-do), acidity, and tasting notes.

Learn more: Sake Grade System · Brewery Profiles

Command-Line Interface

# List installed beverage packages
drinkfyi list

# Search via specific client
drinkfyi search cocktail margarita
drinkfyi search wine "pinot noir"
drinkfyi search beer ipa
drinkfyi search coffee espresso
drinkfyi search whiskey bourbon
drinkfyi search tea matcha
drinkfyi search sake "junmai daiginjo"

API Endpoints

Each beverage site exposes a consistent set of 10 API endpoints. All are free, require no authentication, and return JSON with CORS enabled.

Site	Base URL	Endpoints
CocktailFYI	`	cocktails, ingredients, families, glossary, search, compare, random, guides
VinoFYI	`	wines, grapes, regions, wineries, glossary, search, compare, random, guides
BeerFYI	`	styles, hops, malts, yeast, glossary, search, compare, random, guides
BrewFYI	`	varieties, origins, methods, glossary, search, compare, random, guides
WhiskeyFYI	`	whiskeys, distilleries, regions, glossary, search, compare, random, guides
TeaFYI	`	teas, origins, teaware, glossary, search, compare, random, guides
NihonshuFYI	`	sake, rice, breweries, glossary, search, compare, random, guides

All sites also serve an OpenAPI 3.1.0 specification at /api/v1/openapi.json.

Example

# Search across cocktails
curl -s "https://cocktailfyi.com/api/v1/search/?q=margarita"

# Get a specific beer style
curl -s "https://beerfyi.com/api/v1/styles/new-england-ipa/"

# Compare two wines
curl -s ""

Using Individual Packages

Each beverage package can be used independently:

# Cocktails -- includes local computation engine
from cocktailfyi import parse_measure_ml, compute_abv
ml = parse_measure_ml("2 oz")  # 60.0

# Wine
from vinofyi.api import VinoFYI
with VinoFYI() as api:
    grapes = api.search("pinot noir")

# Beer
from beerfyi.api import BeerFYI
with BeerFYI() as api:
    styles = api.search("ipa")

# Coffee
from brewfyi.api import BrewFYI
with BrewFYI() as api:
    varieties = api.search("gesha")

# Whiskey
from whiskeyfyi.api import WhiskeyFYI
with WhiskeyFYI() as api:
    whiskeys = api.search("islay")

# Tea
from teafyi.api import TeaFYI
with TeaFYI() as api:
    teas = api.search("oolong")

# Sake
from nihonshufyi.api import NihonshuFYI
with NihonshuFYI() as api:
    sake = api.search("daiginjo")

Learn More About Beverages

• Cocktails: | Ingredients | - Wine: Wines | Grapes | Regions | Guides
• Beer: Styles | Hops | Malts | - Coffee: Varieties | Origins | Methods | - Whiskey: | Distilleries | - Tea: | Teaware | Guides
• Sake: Sake | Rice | Breweries | Guides

Beverage FYI Family

Part of the FYIPedia open-source developer tools ecosystem -- world beverages from cocktails to sake.

Site	Domain	Focus
CocktailFYI	cocktailfyi.com	636 cocktails, ABV, calories, flavor profiles
VinoFYI	vinofyi.com	Wines, grapes, regions, wineries, food pairings
BeerFYI	beerfyi.com	112 beer styles, hops, malts, yeast, BJCP
BrewFYI	brewfyi.com	72 coffee varieties, roasting, 21 brew methods
WhiskeyFYI	whiskeyfyi.com	80 whiskey expressions, distilleries, regions
TeaFYI	teafyi.com	60 tea varieties, teaware, brewing guides
NihonshuFYI	nihonshufyi.com	80 sake, rice varieties, 50 breweries

License

MIT