Skip to main content

Natural Language Dispatchers

DS01 supports natural language command syntax using dispatchers.


Overview

Instead of hyphenated commands like container-deploy, you can use space-separated syntax:

container deploy my-project # Same as container-deploy my-project
image create my-project # Same as image-create my-project

Both syntaxes work identically and support all the same options.


Why Both Syntaxes?

SyntaxBest For
container deployTyping at terminal (feels natural)
container-deployScripts, tab completion, muscle memory

Both work identically - use whichever you prefer.


Available Dispatchers

container

Dispatch container lifecycle commands.

container <subcommand> [args] [options]

Subcommands:

SubcommandEquivalentDescription
deploycontainer-deployCreate + start container
retirecontainer-retireStop + remove + free GPU
createcontainer-createCreate container only
startcontainer-startStart in background
runcontainer-runStart and enter
attachcontainer-attachAttach to running
stopcontainer-stopStop container
removecontainer-removeRemove container
pausecontainer-pausePause processes
listcontainer-listList containers
statscontainer-statsResource usage
exitcontainer-exitExit info
helpcontainer --helpShow help

Examples:

container deploy my-project --open
container list
container stats my-project
container retire my-project --force

image

Dispatch image management commands.

image <subcommand> [args] [options]

Subcommands:

SubcommandEquivalentDescription
createimage-createBuild custom image
updateimage-updateRebuild image
listimage-listList images
deleteimage-deleteRemove image
helpimage --helpShow help

Examples:

image create my-project
image list
image update my-project --no-cache
image update my-project --add "pandas numpy"

project

Dispatch project setup commands.

project <subcommand> [args] [options]

Subcommands:

SubcommandEquivalentDescription
initproject-initInitialize new project
helpproject --helpShow help

Examples:

project init my-thesis
project init my-experiment --guided

user

Dispatch user setup commands.

user <subcommand> [args] [options]

Subcommands:

SubcommandEquivalentDescription
setupuser-setupComplete onboarding
helpuser --helpShow help

Examples:

user setup
user setup --guided

check

Dispatch resource checking commands.

check <subcommand> [args]

Subcommands:

SubcommandEquivalentDescription
limitscheck-limitsShow your resource limits and usage
helpcheck --helpShow help

Aliases: get limits also works (routes to same command).

Examples:

check limits # Show your resource limits and current usage
check-limits # Same as above (hyphenated version)

Getting Help

Each dispatcher shows available subcommands:

container help # or: container --help
image help # or: image --help
project help # or: project --help
user help # or: user --help

See Also