# Roastbook

> Log espresso shots on your own server — A self-hosted coffee journal that reads a photographed bag’s label and fills in the details for you.

- Page: https://tesign.com/en/item/roastbook/
- JSON: https://tesign.com/en/item/roastbook/index.json
- Korean Markdown: https://tesign.com/item/roastbook/index.md
- Generated: 2026-09-22 07:26 UTC

## Numbers

- 2 stars — checked on GitHub 2026-09-14 23:21 UTC
- no 7-day star increase observed (GH Archive) (as of 2026-09-22 03:00 UTC)
- 1 Show HN points — observed 2026-09-21 06:15 UTC
- Star total = the value last checked on GitHub (stars_checked_at) + increases observed via GH Archive since. The 24h · 7d · 30d gains are GH Archive hourly events summed to the reference time (as_of). No score of ours.

## AT A GLANCE

- LICENSE: MIT (permissive) — https://spdx.org/licenses/MIT.html
- USAGE: Use, change and redistribute, commercially too. Keep the notice.
- OPEN SOURCE: YES
- LANGUAGE: TypeScript
- PLATFORM: web · linux
- CATEGORY: PRODUCTIVITY
- Tags: 커피 · 자체 설치 · postgresql · ai 라벨 인식
- How to start: Self-host
- SOURCES: Show HN https://github.com/michidk/roastbook
- SELF-HOST: https://roastbook.vercel.app/

## ACTIVITY

- Last commit: 2026-09-14 14:10 UTC
- Latest release: [unconfirmed]
- Contributors: [unconfirmed]
- Open issues (incl. PRs): [unconfirmed]
- Made by: [unconfirmed]
- Checked on GitHub: 2026-09-14 23:21 UTC

## Signals and evidence

- NEW · 10h OLD WHEN SEEN

## TESIGN TAKE

Having a read-only demo on bundled sample data means you can see the real screens before installing anything.

## WHY IT MATTERS

Keeping a record of beans, roasters and brews usually means the data lives on someone else’s server. Roastbook is meant to run on your own, and a single photo of the bag fills in origin, variety and roast level; typing a roaster’s name looks up its site and location. A quick brew log takes three numbers.

## BUILD FROM THIS

- It runs on PostgreSQL and your own storage, deployed with one Docker Compose command or a Helm chart. The AI features that read a label or research a roaster turn on once OPENAI_API_KEY is set; everything else works without a key. The repository states there are no accounts, no telemetry and no upsell.

## WHO IT'S FOR

- Home espresso and brew enthusiasts, and anyone who wants their coffee log kept on their own server.

## START IN 5 MINUTES

```
# Try the read-only demo at roastbook.vercel.app first, then deploy it yourself with Docker Compose.
```

## CAVEATS

- The AI features need your own OpenAI key and cost accordingly. It is early — two stars.

## RECEIPT

- FIRST SEEN BY TESIGN: 2026-09-14 23:06 UTC
- AT SOURCE: 2026-09-14 13:06 UTC
- KEPT: 2026-09-22 05:53 UTC
- Published on TESIGN: 2026-09-22 05:53 UTC
- Text last updated: 2026-09-22 05:53 UTC

## How to read this

- This file was produced by the same build, from the same data, as the tesign.com item page. The text is editorial; the numbers are stored observations.
- null in the JSON means not observed — never zero. The Markdown writes [unconfirmed] for it.
- Star total = the value last checked on GitHub (stars_checked_at) + increases observed via GH Archive since. The 24h · 7d · 30d gains are GH Archive hourly events summed to the reference time (as_of). No score of ours.
- A summary, not legal advice.

[Image] https://tesign.com/img/roastbook-fa2cf185e1.png