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.

Installation

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!

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

Project details


Download files

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

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

valohai_cli-0.33.0-py3-none-any.whl (99.1 kB view details)

Uploaded Python 3

File details

Details for the file valohai_cli-0.33.0-py3-none-any.whl.

File metadata

  • Download URL: valohai_cli-0.33.0-py3-none-any.whl
  • Upload date:
  • Size: 99.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for valohai_cli-0.33.0-py3-none-any.whl
Algorithm Hash digest
SHA256 73dbb038bdc0719297a60abaf624e88a0bd976c3ea045ba97bed68482d989d1a
MD5 c385721c988882371cb15a5b4ecf049c
BLAKE2b-256 ab27286c969df79e4596bd755a1b830ba49d992254387c90a7c46b52203ecc47

See more details on using hashes here.

Supported by

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