Installation

Install the VAI command-line interface.

Using pip

pip install vai-client

Using uv (Recommended)

uv pip install vai-client

From Source

For development:

# Clone the repository
git clone https://github.com/virtuousai/vai-client.git
cd vai-client

# Install in editable mode
cd apps/cli
uv pip install -e .

Verify Installation

vai --version
# vai-cli 0.1.0

Shell Completion

Enable tab completion for your shell:

Bash

# Add to ~/.bashrc
eval "$(_VAI_COMPLETE=bash_source vai)"

Zsh

# Add to ~/.zshrc
eval "$(_VAI_COMPLETE=zsh_source vai)"

Fish

# Add to ~/.config/fish/completions/vai.fish
_VAI_COMPLETE=fish_source vai | source

Configuration

The CLI stores configuration in ~/.config/vai/ or the path specified by VAI_CONFIG_DIR:

File	Purpose
`config.toml`	API URLs and profile settings
`credentials/`	Encrypted token storage

Environment Variables

Variable	Description
`VAI_PROFILE`	Override the active profile
`VAI_API_URL`	Override the API URL
`VAI_CONFIG_DIR`	Custom config directory

Next Steps

Authentication - Set up credentials
Commands - Explore available commands

Installation

On this page