CLI installation

How to install the OctoAI CLI

Latest CLI release

You can install the latest CLI and Python SDK using the script below, with compatibility for both Mac and Linux systems.

$curl -sSfL | sh

Verify the installation

$octoai version
$octoai --help

You can also verify the octoai-sdk has successfully installed in your correct environment.

$python3 -m pip show octoai-sdk

This should provide an output similar to (though likely with different version numbers):

Name: octoai-sdk
Version: 0.7.1
Summary: A runtime library for OctoAI.
Author: OctoAI
Location: /Users/sliu/anaconda3/envs/sdk-dev/lib/python3.10/site-packages
Requires: boto3, chevron, click, fastapi, httpx, numpy, pillow, pydantic, python-dateutil, python-multipart, pyyaml, soundfile, types-pyyaml, types-requests, uvicorn

Uninstall the CLI and Python SDK

Our installation script installs the OctoAI binary to usr/local/bin. You can remove it with:

$rm -rf /usr/local/bin/octoai

You can uninstall the Python SDK using:

1python3 -m pip uninstall octoai-sdk

If you used another method of installation such as brew, rpm, etc, please follow the directions from those services.

If you choose not to install the CLI and SDK using the installation script, you can alternatively use brew or apt. For most people, it is recommended you use the installation script.

Please note, if you install the CLI using brew or apt, you will also need to install the SDK directly from PIP. You can review the installation shell script from CLI & SDK Installation to verify a compatible SDK version number if you run into difficulties, and also review there how to verify the installation was successful for both the SDK and CLI.

Latest Python SDK Release

Much of the CLI is dependent on the SDK. You can view our full release history on PyPI here.

If you choose not to use the installation script, you can use pip to install the octoai-sdk Python package directly. We strongly recommend that you install OctoAI in a virtualenv, to avoid conflicting with your system packages.

1python3 -m pip install octoai-sdk

If you’ve already installed a previous version of the octoai-sdk, you can also upgrade using:

1python3 -m pip install --upgrade octoai-sdk

Alternate CLI Installation Options

After installing the Python SDK, you can then install the CLI.


1brew tap octoml/tap
2brew install octoai


1sudo add-apt-repository -y 'deb [trusted=yes] /'
2sudo apt update
3sudo apt install octoai

Please see the individual package manager for how to remove an installation, as their directions may change over time.