Takhtabush · v0.1.0

A quiet place to learn.

Self-hosted flashcards for the people who use them, and a small, auditable Cloudflare Worker for the people who run them. Decks, six study modes, a deterministic scheduler, and an MCP endpoint — without a second service.

Open the user guide Self-host it

git clone https://github.com/calycode/takhtabush.git
cd takhtabush
                  && pnpm install && pnpm db:migrate:local && pnpm dev

Takhtabush dashboard with decks and study sessions

For learners

Study your decks

Sign in, build or import decks, study with six modes, and read your progress. No setup, no infrastructure, no developer vocabulary.

Open the user guide → For builders

Self-host or contribute

Deploy one Worker, configure D1 and R2, run the scheduler, connect agents over MCP, and audit the system. Architecture and reference included.

Open the developer guide →

For learners

Built around the study session

Everything in the app points at one thing: getting the next card right.

Decks that stay readable

Markdown definitions, images, audio, tags, folders, import, and export. The deck table stays scannable.

Six study modes

Flashcards, multiple choice, typed, cloze, two matching layouts, and mixed. The launcher only offers what the deck supports.

Progress you can act on

Accuracy, due counts, a two-week schedule, and the weakest cards first. The stats page tells you what to study next.

For builders

One Worker, no hidden service

The SPA, API, media proxy, MCP endpoint, OAuth provider, and cron job deploy together.

A scheduler you can audit

SM-2-inspired, deterministic, and versioned. Review events are append-only; learning state is derived and rebuildable.

MCP for agents

Curated tools, scoped API keys, OAuth for ChatGPT, and an audit row for every write. No arbitrary code execution.

Single tenant by default

The first account is the owner. Allow a small group with an allowlist, or pin the owner address from the start.

See it before you deploy it

Light and dark themes, keyboard-first study, and a dashboard that tells you what is due.

Deck view with Markdown definitions, tags, and card types — Deck view — Markdown definitions, tags, and type-aware cards.

A flashcard study session with the answer revealed — Study — reveal, grade, repeat. Keys 1–4 grade; Space reveals.

Study statistics with accuracy, due counts, and card accuracy — Statistics — accuracy, due counts, schedule, and the weakest cards.

Start with the guide that fits

Both paths lead to the same app. Pick the one that matches what you are doing today.

I'm here to study I'm here to self-host