Notarius is a Go CLI for turning source material into structured artifacts with configured extraction pipelines. The implemented D&D workflow reads Seriatim transcript JSON and can produce NPC, location, and item registries; their source-grounded occurrences; scene descriptions, combat turns, enemy events, and spell casts.

Quickstart

Provide an OpenRouter API key through the environment, then run the maintained minimal example:

OPENROUTER_API_KEY=your-api-key \
  go run ./cmd/notarius run dnd-session \
    --config examples/dnd-minimal.config.yml \
    --input examples/seriatim-minimal-transcript.json

The command publishes a JSON output bundle. Its command syntax and exit behavior are documented in the CLI reference; configuration, credentials, and module selection are owned by the configuration reference.

For the complete ordered D&D workflow, use the complete configuration with its synthetic transcript. It demonstrates all implemented D&D lanes and the supporting campaign references.

Install A Source Release

Install a pinned source release with Go:

GOWORK=off go install \
  gitea.maximumdirect.net/eric/notarius/cmd/notarius@<tag>

Replace <tag> with a stable release tag such as vMAJOR.MINOR.PATCH. The installed command's diagnostic version is described in the CLI reference; maintainers preparing a release should follow Source Releases.

Documentation

CLI reference — commands, flags, output streams, and exits.
Configuration reference — configuration files, profiles, validation, and module selection.
Operations — output, state, recovery, and debug handling.
Integration contracts — Seriatim input and published artifact formats.
Subprocess consumer guide — invoke Notarius from an orchestrator and consume a published result.
Complete D&D consumer guide — run the full D&D pipeline as a subprocess and discover its structured artifacts.
Internal overview — implemented component map for maintainers.
Developer guide — contributor orientation and validation guidance.
Future work — unimplemented ideas and priorities.