Skip to main content

Valohai Command Line Client

CI Codecov PyPI MIT License

This is the command-line client for the Valohai machine learning IaaS platform.

Installation

valohai-cli supports Python 3.10 and higher.

  • If you still need to run on Python 3.5, version 0.13.0 was the last one to support it.
  • If you still need to run on Python 3.6, version 0.23.0 was the last one to support it.
  • If you still need to run on Python 3.7, version 0.25.0 was the last one to support it.
  • If you still need to run on Python 3.8, version 0.33.0 was the last one to support it.
  • If you still need to run on Python 3.9, version 0.35.0 was the last one to support it.

System-wide or user-wide installation with pipx

The recommended way to install valohai-cli system-wide is to use pipx, an utility to install and run Python applications in isolated environments. (If you're familiar with Node.js's npx tool, it's the same idea.)

This ensures that valohai-cli's dependencies don't conflict with other Python packages.

Once you have installed and configured pipx (see the link above), you can

$ pipx install valohai-cli

and to upgrade it later on,

$ pipx upgrade valohai-cli

System-wide or user-wide installation with pip

You can also install valohai-cli system-wide with pip, but this may cause conflicts with other Python packages installed system-wide or user-wide.

$ pip3 install -U valohai-cli

The -U flag ensures that any present version is upgraded, too.

Installation in a virtual environment

If you prefer to install valohai-cli in a virtual environment, you can do so with pip as well.

$ python3 -m venv venv
$ source venv/bin/activate
$ pip install -U valohai-cli

Getting Started

After you've installed the client, vh should work and you should see a description of commands.

See the tutorial document!

Developing

Development requires Python 3.10+; otherwise you'll get false positive type failures. CI will run tests on older Python versions.

To work on the valohai-cli code: pull the repository, create and activate a virtualenv, then run:

make dev

This installs valohai-cli as an "editable" vh command available in the virtualenv, but linked to the working copy's source. That is, you can now edit the source under valohai_cli in your working directory, and try it out with vh.

vh --help
# Usage: vh [OPTIONS] COMMAND [ARGS]...

To run lints, type checks and tests:

# run linting and type checks
make lint

# run tests
make test

Release files for valohai-cli 0.37.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for valohai-cli 0.37.0
File Interpreter ABI Platform
valohai_cli-0.37.0-py3-none-any.whl Python 3 none any Details

Release files / valohai_cli-0.37.0-py3-none-any.whl

Download URL valohai_cli-0.37.0-py3-none-any.whl
Size 119.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
417b07ed077ce895f78a284678e152c362823d3458895857108cd0b27ce89710
BLAKE2b-256 checksum
How to use checksums
22ee4369f706881be9122942ed03c2347f61998c4a610be11ac478a6224b59a7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.7

Release history Release notifications | RSS feed

This release

0.37.0 This release

1 release file

0.36.0

1 release file

0.35.0

1 release file

0.34.0

1 release file

0.33.0

1 release file

0.32.0

1 release file

0.31.0

1 release file

0.30.1

1 release file

0.30.0

1 release file

0.29.0

1 release file

0.28.0

1 release file

0.27.0

2 release files

0.25.0

2 release files

0.24.0

2 release files

0.22.2

2 release files

0.22.0

2 release files

0.21.0

2 release files

0.20.1

2 release files

0.20.0

2 release files

0.19.0

2 release files

0.18.0

1 release file

0.16.0

2 release files

0.15.1

2 release files

0.15.0

2 release files

0.13.0

2 release files

0.10.3

2 release files

0.10.2

2 release files

0.10.1

2 release files

0.10.0

2 release files

0.9.1

2 release files

0.9.0

2 release files

0.8.0

2 release files

0.7.0

2 release files

0.6.2

2 release files

0.6.1

2 release files

0.6.0

2 release files

0.5.0

2 release 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