Notarius
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
Set OPENROUTER_API_KEY in your environment, then run the maintained
minimal example with its synthetic transcript:
go run ./cmd/notarius run dnd-session \
--config examples/dnd-minimal/config.yml \
--input-file examples/dnd-minimal/transcript.json
This makes model calls and publishes domain JSON artifacts. 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, ordered generated references, native resource customization, and optional source auxiliaries. See the complete workflow for invocation and discovery.
Install A Source Release
Source builds require Go at or above the consumer minimum declared in
go.mod. Go 1.27.0 is required by the selected ConfigKit
dependency.
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, domain artifacts, and native ConfigKit, PromptKit, and CommandKit boundaries.
- 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.
- Native migration guide — move existing configurations, invocations, and consumers to the native surface.
- Future work — separate backlog of ideas and priorities.
Notarius is licensed under the GPL v3.0 or later.
Open Source attribution notices are available.