A Python command-line interface wrapper for the RunPod HTTP API. This CLI provides easy access to RunPod's endpoints with support for multiple output formats and comprehensive filtering options and can do things that are impossible to do in the official runpodctl tool.

Installation

Option 1: Install as a Package (Recommended)

This allows you to use runpod-cli command from anywhere in your terminal:

After installation, you can use the CLI from anywhere:

Option 2: Run Directly with Python

If you prefer not to install the package:

# Install dependencies
pip install -r requirements.txt

# Run directly
python runpod_cli.py --help

API Token

An API token is necessary for most CLI commands. You can provide your RunPod API token in two ways:

1. Command-line option: Use the --token flag
2. Environment variable: Set RUNPOD_API_TOKEN

# Using environment variable (recommended)
export RUNPOD_API_TOKEN=your_api_token_here

# Or pass directly in command
runpod-cli billing pods --token your_api_token_here

Usage

Refer to the CLI reference for a full description of all possible options.

License

See LICENSE.

This is a wrapper around the RunPod API. Please refer to RunPod's terms of service for API usage guidelines.