Examples

Start from the two canonical examples in the repo; everything else is optional or exploratory.

Canonical (copy these first)

Example	Use it for
examples/habitat-minimal	Smallest Habitat work-dir layout, habitat CLI, native sessions habitat introspection
examples/model-showdown	Multi-dimension evaluations, suite-config.ts, eval combine, suite reports

Clone the repo, pnpm install, set .env, then follow each README from the repo root (use dotenvx run -- before CLI commands that need keys).

I want to…

Goal	Doc or script
Install & first commands	Getting started
Habitat agents & interfaces	Habitat, Habitat interfaces
Model evaluation & combine	Model evaluation, Creating evaluations, Model showdown walkthrough
Tool calling & Stimulus	Tool calling
Structured output	Structured output
MCP chat pattern	MCP chat
Programmatic API	API overview
Runner / strategy details	Evaluation framework (architecture)

More topic guides (sidebar)

The VitePress Examples sidebar lists narrative pages: text generation, creative writing, batch/matrix evaluations, PDF/images, cost optimization, etc. Those pages supplement the canonical repos above; they are not separate git examples.

EvalSuite examples (repo)

Working EvalSuite evaluations in examples/evals/:

dotenvx run -- pnpm tsx examples/evals/car-wash.ts          # common-sense reasoning
dotenvx run -- pnpm tsx examples/evals/instruction.ts       # instruction following
dotenvx run -- pnpm tsx examples/evals/reasoning.ts         # reasoning quality

Script demos (repo)

From the umwelten repo root:

dotenvx run -- pnpm tsx scripts/examples/car-wash-test.ts

For integration-style / manual test scripts (Dagger, tool conversations, reasoning streams), see TESTING.md in the repo.