92 lines
5.4 KiB
Markdown
92 lines
5.4 KiB
Markdown
# Maintained Examples
|
|
|
|
These files are safe, copyable starting points for Narratio configuration and
|
|
input structure. Replace placeholder identifiers, storage names, integration
|
|
URLs, and paths for the target environment. Field meanings and defaults belong
|
|
in the [configuration reference](../docs/config.md).
|
|
|
|
## Pipeline Configuration
|
|
|
|
- [Minimal pipeline](pipeline.minimal.yml): campaign discovery plus the required
|
|
WhisperX URL.
|
|
- [Production-shaped pipeline](pipeline.production.yml): S3 storage, publish,
|
|
external tools, and configured Scriptorium artifacts.
|
|
- [Production-base/testing-overlay bundle](production-testing/pipeline.yml):
|
|
explicit required `conf.d` imports, an optional local import, destination-mounted
|
|
artifact files, a YAML-filtered directory of keyed families, and the fixed
|
|
`overlays/testing.yml` overlay. Production values live in the base. The
|
|
bundle demonstrates an input-only artifact dependency, two character families
|
|
sharing the campaign party, and a testing-only disabled artifact. The testing
|
|
overlay's `testing_notes` artifact inherits the recap prompt, inputs, and
|
|
testing profile while retaining its disabled status and separate output path.
|
|
The testing overlay upserts the transcript publish rule by `source`. A
|
|
destination key defines each artifact ID; filenames do not. Full-root and
|
|
disjoint definitions are also valid. Upsert replaces a matching list record
|
|
as a whole; empty append or upsert contributions leave existing entries intact.
|
|
Inspect it offline with:
|
|
|
|
```sh
|
|
narratio config validate --config examples/production-testing/pipeline.yml --campaign-file examples/campaigns/sample-campaign/campaign.yml
|
|
narratio config show --config examples/production-testing/pipeline.yml --campaign-file examples/campaigns/sample-campaign/campaign.yml --overlay testing
|
|
narratio config sources --config examples/production-testing/pipeline.yml --campaign-file examples/campaigns/sample-campaign/campaign.yml --overlay testing
|
|
narratio config artifacts --config examples/production-testing/pipeline.yml --campaign-file examples/campaigns/sample-campaign/campaign.yml --overlay testing
|
|
narratio config diff default testing --config examples/production-testing/pipeline.yml --campaign-file examples/campaigns/sample-campaign/campaign.yml
|
|
```
|
|
|
|
These inspection commands load configuration and resolve explicit credential
|
|
references, but do not load a session or create runtime state. This bundle is
|
|
intentionally local-storage and credential-reference free so the walkthrough
|
|
needs no tools or cloud services.
|
|
- [Full annotated pipeline](pipeline.full.annotated.yml): every implemented
|
|
pipeline section with explanatory comments.
|
|
- [Extraction subset pipeline](pipeline.extraction-subset.yml): a focused
|
|
Scriptorium artifact consuming only three declared Notarius lanes.
|
|
|
|
The existing `internal/config` example test loads and validates each pipeline
|
|
with the sample campaign and a compatible local- or S3-audio session.
|
|
|
|
## Campaign And Session Configuration
|
|
|
|
- [Sample campaign](campaigns/sample-campaign/campaign.yml), its
|
|
[session template](campaigns/sample-campaign/session.template.yml), and its
|
|
adjacent stable inputs provide a complete campaign directory shape. Its
|
|
imported settings and split party demonstrate local secondary imports;
|
|
relative resources follow the file that supplies each value.
|
|
- [Local-audio session](session.local-audio.yml) and
|
|
[S3-audio session](session.s3-audio.yml) are concrete session files.
|
|
- [Session template](session.template.yml) and the campaign-local equivalent
|
|
demonstrate the narrow placeholder syntax consumed by `session init`; they
|
|
are templates, not runtime session files.
|
|
|
|
## Input Fixtures
|
|
|
|
- [Speakers](speakers.yml), [autocorrect](autocorrect.yml), and
|
|
[glossary](glossary.yml) show the standalone input shapes.
|
|
- The sample campaign references its local
|
|
[speakers](campaigns/sample-campaign/speakers.yml),
|
|
[autocorrect](campaigns/sample-campaign/autocorrect.yml),
|
|
[glossary](campaigns/sample-campaign/glossary.yml), and canonical
|
|
[party](campaigns/sample-campaign/party.yml) fixture, plus an optional
|
|
[spell-catalog overlay](campaigns/sample-campaign/spell_catalog.json) that
|
|
follows the Notarius v0.7 contract. Narratio derives the players projection
|
|
from this party source.
|
|
- [Sample speaker audio](audio/sample-speaker.flac) is a text placeholder that
|
|
reserves the expected filename and directory shape. Replace it with a real
|
|
FLAC file before running transcription.
|
|
|
|
The examples contain environment-variable names but no credential values. Set
|
|
`OBJECT_STORAGE_KEY_ID`, `OBJECT_STORAGE_KEY`, `AUDITA_LLM_API_KEY`, and
|
|
`NOTARIUS_LLM_API_KEY` to nonempty synthetic or real values before loading the
|
|
examples that reference them. They use fictional campaign content and reserved
|
|
example domains. The Audita and Notarius names are example references, not
|
|
implicit aliases: external backend/profile configurations must use those exact
|
|
names, or the Narratio credential lists must be changed to match. See the
|
|
[Audita v2 migration guide](https://gitea.maximumdirect.net/eric/audita/src/tag/v2.0.0/docs/migrations/v2.md)
|
|
for maintained downstream configuration examples.
|
|
|
|
For a deployed bundle, keep credential files out of source control in the
|
|
conventional `/usr/local/etc/narratio/secrets` directory, one file per referenced
|
|
environment-variable name, or select another directory with `--secrets-dir`.
|
|
Static S3 credentials are optional: omit both S3 credential references to use
|
|
the AWS SDK discovery chain.
|