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.5.tar.gz (489.0 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.5-py3-none-any.whl (301.7 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for yellowdog_cli-10.8.5.tar.gz
Algorithm Hash digest
SHA256 ee86d268e05a6dd10f0580472c4d362fc3f788de0a176bf21ddf41363798c403
MD5 fb75018121969315acd5e185183c9023
BLAKE2b-256 173c6181b345d1cefa73b35d02111e229a00e2af40def1db43bd3acb7dd85a3f

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for yellowdog_cli-10.8.5-py3-none-any.whl
Algorithm Hash digest
SHA256 e91ae595e8e0387db0dbf5f4b2399a8f61d4ab2e3604d174288a9e64eee52edb
MD5 89ca595cac2fb52af5a4602d813e3130
BLAKE2b-256 4b1d4c121a91aa3f48e2a37f9d430d88863ee4a455cbe8a8de2700650270368f

See more details on using hashes here.

Release history Release notifications | RSS feed

10.8.7

2 files

10.8.6

2 files

This release

10.8.5 This release

2 files

10.8.4

2 files

10.8.3

2 files

10.8.2

2 files

10.8.1

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