Poe tasks (shortcuts)¶

poethepoet tasks, defined in pyproject.toml, wrap the CLIs under CLI reference for common workflows. Run any of them with uv run poe <task>.

Validate¶

Task	Command
Full validate	`uv run poe validate`
Schema / align / registry only	`uv run poe validate-schemas` · `validate-align` · `validate-registry`
Validate in Docker	`uv run poe container-cli validate-schemas` (alias: `soju`; any `soju` args) · full suite: `docker compose run --rm --no-deps backend poe validate`

Compose¶

Task	Command
Dev (Vite :14321, API :14322, docs :14323)	`uv run poe container-up-dev` (alias: `up`)
Prod (nginx :8080 only)	`uv run poe container-up-prod` (alias: `up-prod`)
Stop / remove containers	`uv run poe container-down` · `--volumes` drops named volumes
Rebuild images (exit when done)	`uv run poe container-build` (alias: `build`)
Pull default Ollama models	`uv run poe setup-ollama`

See Docker for the full Compose layout.

Import, translate & embed¶

Task	Command
Import words (file, merge-only)	`uv run poe import-words --file words.txt --topic common`
Import verbs (stdin JSON)	`uv run poe import-verbs`
Translate words → JSON	`uv run poe translate-words --file words.txt`
Build Practice embedding cache	`uv run poe embed-index`

Test & docs¶

Task	Command
Python tests (unit + offline system)	`uv run poe test`
System / LLM / all / coverage	`uv run poe test-system` · `test-llm` · `test-all` · `coverage`
Build docs	`uv run poe docs`
Serve docs (live reload, :14323)	`uv run poe docs-serve` · `--port N`

Lint & pre-commit¶

Task	Command
Lint	`uv run poe lint`
Pre-commit (all hooks)	`uv run poe pre-commit`