models:branch
rai models:branch [OPTIONS] <BRANCH_NAME>Create a new model branch (schema) named BRANCH_NAME from the current model.
BRANCH_NAME is the new branch’s schema name. The parent is the
current model schema (deployment.schema in raiconfig), matching
rai models deploy/switch.
Naming the schema you are already on is recognized and refused with that
reason, rather than the generic “already exists, use switch” advice — which
would tell you to switch to the schema you are already on. The check runs
after the parent has been validated, so a deployment.schema pointing at
a schema that no longer exists still gets the “deploy the parent” advice that
actually fixes it. Comparison follows the backend: JSONL keys models on the
raw name, so MAIN and main are distinct there, while Snowflake folds
them together.
Options
| Option | Type | Description |
|---|---|---|
--static | Boolean | Create a static (frozen) branch: its parent stays frozen at the fork; catch up later with rai models pull --from-parent. Default: False. |