The Vellum CLI is a command line interface for interacting with Vellum. It allows you to push and pull resources defined in both the Vellum application and the Vellum SDKs.

Pull

vellum workflows pull

Used to pull Vellum resources from the Vellum application into the local SDK.

Arguments

[module]

str

The module to pull the workflow into. If not provided, a module will be generated based on the Workflow Sandbox ID.

--workflow-sandbox-id

str

Pull the Workflow from a specific Sandbox ID. If not provided, the Workflow Sandbox ID defined in the pyproject.toml associated with [module] will be used. Must be provided if [module] is not provided.

--workflow-deployment

str

Pull the Workflow from a specific Deployment. Can use the name or the ID of the Deployment.

--include-json

bool

Include the JSON representation of the Workflow in the pull response. Should only be used for debugging purposes.

--exclude-code

bool

Exclude the code definition of the Workflow from the pull response. Should only be used for debugging purposes.

Push

vellum workflows push

Used to push Vellum resources defined with the SDK to the Vellum application.

Arguments

[module]

str

The module to push from local. If not provided, the first module defined in the pyproject.toml file will be used.

--deploy

bool

If provided, the Workflow will be automatically deployed once pushed to Vellum.

--deployment-label

str

The label to use for the deployment. Can only be provided if --deploy is also provided.

--deployment-name

str

The name to use for the deployment. Can only be provided if --deploy is also provided.

--deployment-description

str

The description to use for the deployment. Can only be provided if --deploy is also provided.

--release-tag

List[str]

The release tags to use for the deployment. Can only be provided if --deploy is also provided.