Skip to main content

Command Line Interface for the YellowDog Platform

Overview

This is a set of Python CLI commands for interacting with the YellowDog Platform, also providing examples of usage of the YellowDog Python SDK.

The commands support:

  • Aborting running Tasks with the yd-abort command
  • Boosting Allowances with the yd-boost command
  • Cancelling Work Requirements with the yd-cancel command
  • Comparing whether Worker Pools are a match for Task Groups with the yd-compare command
  • Creating, Updating and Removing Compute Source Templates, Compute Requirement Templates, Keyrings, Credentials, Image Families, Allowances, Configured Worker Pools, User Attributes, Namespace Policies, Groups, and Applications with the yd-create and yd-remove commands
  • Copying files between remote data stores with the yd-copy command
  • Deleting files from a remote data store with the yd-delete command
  • Downloading files from a remote data store with the yd-download command
  • Finishing Work Requirements with the yd-finish command
  • Following Event Streams for Work Requirements, Worker Pools and Compute Requirements with the yd-follow command
  • Waiting for Work Requirements, Worker Pools or Compute Requirements to reach a terminal state with the yd-wait command
  • Instantiating Compute Requirements with the yd-instantiate command
  • Listing YellowDog items using the yd-list command
  • Listing remote data store contents with the yd-ls command
  • Provisioning Worker Pools with the yd-provision command
  • Resizing Worker Pools and Compute Requirements with the yd-resize command
  • Showing the details of any YellowDog entity using its YellowDog ID with the yd-show command
  • Showing the details of the current Application with the yd-application command
  • Shutting Down Worker Pools and Nodes with the yd-shutdown command
  • Submitting Node Actions to Worker Pool nodes with the yd-nodeaction command
  • Starting HELD Work Requirements and Holding (or pausing) RUNNING Work Requirements with the yd-start and yd-hold commands
  • Submitting Work Requirements with the yd-submit command
  • Terminating Compute Requirements with the yd-terminate command
  • Uploading files to a remote data store with the yd-upload command
  • Cloud provider setup (AWS, Azure, GCP) with the yd-cloudwizard command

Utility commands are also provided: yd-format-json, yd-help, yd-jsonnet2json, and yd-version. For a full list of commands run yd-help.

Installation

Python 3.10 or later is required.

pipx (recommended) — installs into an isolated environment and puts the commands on your PATH automatically:

pipx install yellowdog-cli

uv:

uv tool install yellowdog-cli

pip + virtual environment:

pip install yellowdog-cli

To add optional Jsonnet support:

pipx inject yellowdog-cli jsonnet   # pipx
uv tool install "yellowdog-cli[jsonnet]"   # uv
pip install "yellowdog-cli[jsonnet]"       # pip

Commander GUI

An optional desktop GUI is available. Install it with the commander extra and launch it with yd-commander:

pip install -U "yellowdog-cli[commander]"
yd-commander

Documentation

Please see the documentation in the GitHub repository for full details.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

yellowdog_cli-10.8.1.tar.gz (456.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

yellowdog_cli-10.8.1-py3-none-any.whl (288.9 kB view details)

Uploaded Python 3

File details

Details for the file yellowdog_cli-10.8.1.tar.gz.

File metadata

  • Download URL: yellowdog_cli-10.8.1.tar.gz
  • Upload date:
  • Size: 456.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.14.6

File hashes

Hashes for yellowdog_cli-10.8.1.tar.gz
Algorithm Hash digest
SHA256 7e1fd3b133f042d73c45404263bb24ee2978a840fca987f7bbabd77d02ba2f06
MD5 356df78896f94e06b5481f36ef13efa2
BLAKE2b-256 9c668197f13ceb76d5b272b0ddd1224606a1cf6cceb5542219273b94b1611df5

See more details on using hashes here.

File details

Details for the file yellowdog_cli-10.8.1-py3-none-any.whl.

File metadata

  • Download URL: yellowdog_cli-10.8.1-py3-none-any.whl
  • Upload date:
  • Size: 288.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.14.6

File hashes

Hashes for yellowdog_cli-10.8.1-py3-none-any.whl
Algorithm Hash digest
SHA256 4a5d8b9595ff096f491c14b80ae2d8413410dc0f97fb513094a6436568e8126c
MD5 fae3535f0727b18195fba52e64a591ba
BLAKE2b-256 9c788a76ad510ba6f821671b73798b4a710fdfb5ab0de3512f4e533d0e8545d1

See more details on using hashes here.

Release history Release notifications | RSS feed

10.8.7

2 files

10.8.6

2 files

10.8.5

2 files

10.8.4

2 files

10.8.3

2 files

10.8.2

2 files

This release

10.8.1 This release

2 files

10.8.0

2 files

10.7.1

2 files

10.7.0

2 files

10.6.0

2 files

10.5.0

2 files

10.4.0

2 files

10.3.1

2 files

10.3.0

2 files

10.2.0

2 files

10.1.0

2 files

10.0.1

2 files

10.0.0

2 files

9.7.0

2 files

9.6.1

2 files

9.6.0

2 files

9.5.0

2 files

9.4.1

2 files

9.4.0

2 files

9.3.5

2 files

9.3.4

2 files

9.3.3

2 files

9.3.2

2 files

9.3.1

2 files

9.3.0

2 files

9.2.4

2 files

9.2.3

2 files

9.2.2

2 files

9.2.1

2 files

9.2.0

2 files

9.1.1

2 files

9.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page