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