brewfyi

brewfyi

TypeScript API client for BrewFYI -- the complete coffee reference with 72 coffee varieties, 21 brew methods, 20 origin countries, and 120 expert guides covering Arabica genetics, processing methods, SCA cupping protocols, and roast profiling. Zero dependencies, uses native fetch.

Explore coffee at brewfyi.com -- Varieties | Brew Methods | Origins | API Docs

Table of Contents

• Install
• Quick Start
• What You Can Do
  • Coffee Species and Varieties
  • Processing Methods
  • Brew Methods
  • Roast Levels
• API Reference
• TypeScript Types
• Learn More About Coffee
• Also Available for Python
• Beverage FYI Family
• License

Install

npm install brewfyi

Works in Node.js, Deno, Bun, and browsers (ESM).

Quick Start

import { BrewFYI } from "brewfyi";

const api = new BrewFYI();

// Search varieties, brew methods, origins, glossary
const results = await api.search("espresso");

// Get coffee variety detail
const gesha = await api.variety("gesha");
console.log(gesha.flavor_profile); // ["jasmine", "bergamot", "peach"]

// Get brew method parameters
const v60 = await api.method("v60");
console.log(v60.brew_time, v60.grind_size);

// Compare two varieties
const comparison = await api.compare("gesha", "bourbon");

What You Can Do

Coffee Species and Varieties

All commercial coffee comes from two primary species: Coffea arabica (60-70% of world production) and Coffea canephora (Robusta, 30-40%). BrewFYI catalogs 72 distinct varieties with genetic lineage, flavor profiles, and growing requirements.

Category	Notable Varieties	Characteristics
Ethiopian Heirlooms	Gesha, Yirgacheffe Landrace	Floral, jasmine, bergamot
Bourbon Lineage	Bourbon, Caturra, Catuai	Sweet, balanced, caramel
Typica Lineage	Typica, Blue Mountain, Kona	Clean, sweet, mild body
Hybrid/Modern	Castillo, Catimor	Disease resistant
Robusta	Robusta, Conilon	High caffeine, earthy

Processing Methods

Post-harvest processing dramatically affects flavor. The same cherry processed differently produces entirely different cup profiles:

Method	Flavor Impact
Washed	Clean, bright acidity, clarity
Natural	Fruity, wine-like, heavy body
Honey	Sweet, balanced, complex
Anaerobic	Intense, unique fermentation

Brew Methods

21 brewing methods with optimal parameters for water temperature, grind size, brew ratio, and extraction time:

Method	Type	Brew Time	Best For
Espresso	Pressure (9 bar)	25-30s	Concentrated, crema
Pour Over (V60)	Drip	2:30-3:30	Clarity, origin character
French Press	Immersion	4:00	Full body, oils
Cold Brew	Cold immersion	12-24h	Smooth, low acidity

Roast Levels

Level	Internal Temp	Characteristics
Light	180-205C	Bright acidity, floral, fruity
Medium	220-230C	Balanced body, chocolate, nuts
Dark	240C+	Smoky, bitter, minimal origin character

API Reference

Method	Description
search(query)	Search varieties, methods, origins, glossary
glossaryTerm(slug)	Get glossary term definition
variety(slug)	Coffee variety detail with genetics, flavor
method(slug)	Brew method detail with parameters
processing(slug)	Processing method detail
roast(slug)	Roast level detail
country(slug)	Origin country detail
compare(slugA, slugB)	Compare varieties or methods
random()	Random coffee variety

TypeScript Types

import type { SearchResult, GlossaryTerm, VarietyDetail, MethodDetail, ProcessingDetail, RoastDetail, CountryDetail, CompareResult, RandomResult } from "brewfyi";

Learn More About Coffee

• Reference: Varieties | Origins | Brew Methods
• Guides: Coffee Guides | Glossary
• API: Developer Docs | OpenAPI Spec
• Python: PyPI Package

Also Available for Python

pip install brewfyi

See the Python package on PyPI.

Beverage FYI Family

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

Package	PyPI	npm	Description
cocktailfyi	PyPI	npm	636 cocktails, ABV, calories -- cocktailfyi.com
vinofyi	PyPI	npm	Wines, grapes, regions, food pairings -- vinofyi.com
beerfyi	PyPI	npm	112 beer styles, hops, malts -- beerfyi.com
brewfyi	PyPI	npm	72 coffee varieties, brew methods -- brewfyi.com
whiskeyfyi	PyPI	npm	80 whiskey expressions, distilleries -- whiskeyfyi.com
teafyi	PyPI	npm	60 tea varieties, teaware -- teafyi.com
nihonshufyi	PyPI	npm	80 sake, rice varieties -- nihonshufyi.com

License

MIT