For learners

Start with the learner lessons in docs/learner/. Each lesson tells you which checkpoint to check out, what to change in code or configure in Langfuse, and how to verify the result.

Use the learner path if you want to:

• Log your first trace from a real LLM app and understand what you are looking at.
• Move a prompt into Langfuse so changes are versioned and linked to traces.
• Monitor production behavior without reading every trace by hand.
• Build a dataset, run experiments, and evaluate changes with evidence.
• Inspect a complete TypeScript reference implementation you can copy patterns from.

No instructor is required. The learner lessons are complete enough to run the workshop in self-guided mode.

How to work through it

main is the complete reference implementation. For hands-on work, check out the checkpoint named in the lesson you are starting, make the missing changes, and verify the result before moving on.

checkpoint/00-setup and checkpoint/01-base-app intentionally contain the same untraced base app. Setup uses that state to validate keys, dependencies, and ports; Base App uses it for orientation. Tracing starts in 02-tracing.

The workshop server and npm helper scripts treat the repository .env as the Node-side source of truth. Local shell exports from other projects do not override .env, so change workshop keys, Langfuse host, prompt labels, and dataset names in that file.

The workshop is small enough to finish in a sitting, and every module can also be used independently if you only care about one part of the loop.

Where to go next

• Walk the modules in order starting from docs/learner/00-setup.md.
• Jump to whichever chapter matches what you want to learn.
• Install the Langfuse skill (/langfuse) to apply the patterns from this workshop to your own codebase.
• For bigger-picture material on each chapter, use the Langfuse Academy.