HerfBook

Your cigar collection, your tasting journal, your data.

An open-source, self-hosted cigar collection manager and tasting journal. Track your humidors, log smoking sessions with detailed tasting notes, and never lose track of what you're aging, what you've smoked, or what you thought of it.

View on GitHub Read the Design Doc
herf /hurf/ n.
A gathering of people for the purpose of smoking cigars. Coined on alt.smokers.cigar, c. 1996.
HerfBook is your book of herfs — a record of every cigar you collect, smoke, rate, and share.

Everything a serious collection needs

🗄️

Multi-Humidor Inventory

Track boxes, 5-packs, and singles across multiple humidors. Log purchases, vendors, prices, and aging dates. Move cigars between humidors with full provenance.

📓

Structured Tasting Journal

Log draw, burn, ash, strength progression by thirds, flavor tags, pairings, and overall notes. Rate on a 0–100 scale. Quick-log cigars not in your inventory.

📊

Spending Analytics

Track spend per month, average price per stick, cost trends, and vitola preferences over time. See where your money goes and what you actually enjoy.

🤝

Guest Access & Swaps

Share read-only views of your collection with friends via invite links. Track cigar swaps with full provenance — who sent what, when, and from where.

🏷️

Community Reference Data

Ships with community-maintained lookup lists for brands, vitolas, wrappers, and flavor tags. Synced from GitHub. Contribute back via pull request.

🔒

Self-Hosted & Private

Your data stays on your hardware. One-command deploy with Docker Compose. Full export anytime. No subscriptions, no ads, no data harvesting.

Built with

FastAPI PostgreSQL React PWA MinIO Docker Compose
In Development

HerfBook is currently in the design and early development phase. The design document is public and covers the full data model, architecture, and roadmap. Star the repo to follow along.