Skip to main content

Command line client for Valohai

Project description

Valohai Command Line Client

CI Codecov PyPI MIT License

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


valohai-cli supports Python 3.8 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.

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!


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

Project details

Download files

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

Source Distribution

valohai_cli-0.26.0.tar.gz (58.1 kB view hashes)

Uploaded Source

Built Distribution

valohai_cli-0.26.0-py3-none-any.whl (89.6 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page