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.4.tar.gz (480.1 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.4-py3-none-any.whl (297.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: yellowdog_cli-10.8.4.tar.gz
  • Upload date:
  • Size: 480.1 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.4.tar.gz
Algorithm Hash digest
SHA256 e5c9d7a9cf72cea9a5eac080e543209f9ae267d53352b6f57e04c92c1d3dcdc3
MD5 3314843827de4c2d4fd358d925c7d710
BLAKE2b-256 2ddc1bf590c3e5a63614012993c448932d48a0ffce56908d0b2e57485490a8a1

See more details on using hashes here.

File details

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

File metadata

  • Download URL: yellowdog_cli-10.8.4-py3-none-any.whl
  • Upload date:
  • Size: 297.8 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.4-py3-none-any.whl
Algorithm Hash digest
SHA256 aac7e4b698d4a99940dc2e20032f4173130578e06b5e81ae7caa12f39de2023a
MD5 2bcbcad23cb5f8365f5341171755e29d
BLAKE2b-256 421f3628f0d153c9b1a1dbcf413bde52fbcfa1d55df474c0484d7a1746e7de4c

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

This release

10.8.4 This release

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