Zrodlo/Docs

CLI reference

Every command `zrodlo` runs, each with its own page: what it does, every flag, and what it refuses.

How commands read#

Commands are named object then verb: tokenizer, corpus, model and checkpoint are the objects, and commands list describes them all. Every number comes from the command line or config.json; Zrodlo chooses no size, rate, decay, epsilon, probability or seed. A result prints on stdout as field: value lines, nested fields joined by dots, or as one JSON document with --json. Progress prints on stderr. A refusal prints Error: and its cause on stderr and exits with status 1; a missing or malformed flag is a usage error and exits with status 2. A command never overwrites an existing output, and a delete removes nothing without --confirm.

Commands#

CommandWhat it does
tokenizer trainTrain a byte-level BPE tokenizer on text files and write it as a new tokenizer.json
tokenizer inspectLoad a tokenizer and report its vocabulary size, special tokens and digest
tokenizer deleteRemove a tokenizer file; refused without --confirm
corpus prepareEncode text and JSON Lines files with the model's tokenizer into tokens.bin and corpus.json in a new directory
corpus inspectValidate a corpus against its manifest and report the manifest
corpus splitWrite a corpus's last documents to a new held-out corpus and the rest to a new training corpus, without encoding them again
corpus deleteRemove a corpus directory; refused without --confirm
model initWrite a freshly initialized model directory from a configuration
model trainTrain every weight of a model directory, from scratch or continued
model evaluateScore a model directory's saved weights on a corpus; no weight changes
model generateContinue a prompt with a model's saved weights, greedily or by a seeded draw; no weight changes
model inspectValidate a model directory or checkpoint and summarize it
model deleteRemove a model directory or checkpoint; refused without --confirm
checkpoint listList a run's step-<n> checkpoints with their steps and last loss
checkpoint resumeContinue a checkpoint with its own optimizer state and data position
commands listEvery command with its flags, whether each is required, and the values it accepts