Kelvin CLI

Command-line tool to interact with the Kelvin Platform.

Installation

pip install kelvin-sdk

Quick Start

Authentication

kelvin auth login demo.kelvin.ai

This opens your browser for SSO authentication. Alternative authentication methods:

# Client credentials (for automation)
kelvin auth login demo.kelvin.ai --client-id <id> --client-secret <secret>

# Username/password
kelvin auth login demo.kelvin.ai -u <username> -p <password>

# With 2FA
kelvin auth login demo.kelvin.ai -u <username> -p <password> --totp <code>

Explore Commands

Use --tree to see all available commands:

kelvin --tree

Get help for any command:

kelvin --help
kelvin auth --help
kelvin workload deploy --help

Global Flags

These flags are available on all commands:

Flag	Description
`--json`	Output as JSON (for scripting)
`-y`, `--yes`	Skip confirmation prompts
`-v`, `--verbose`	Enable debug logging

JSON Mode

Use --json for machine-readable output:

kelvin workload list --json
kelvin apps list --json | jq '.apps[] | .name'

Scripting

Combine --json and --yes for non-interactive scripts:

kelvin workload undeploy my-workload --json --yes

Command Groups

`auth` - Authentication

kelvin auth login <url>      # Log in to platform
kelvin auth logout           # Log out from platform
kelvin auth token            # Get current access token
kelvin auth reset            # Clear all auth state

`apps` - Application Registry

kelvin apps list             # List applications
kelvin apps search <query>   # Search applications
kelvin apps show <name>      # Show application details
kelvin apps upload <path>    # Upload application
kelvin apps download <name>  # Download application
kelvin apps delete <name>    # Delete application

`app` - Local Application Development

kelvin app create            # Create new application
kelvin app build             # Build application image
kelvin app upload            # Build and upload to registry
kelvin app samples           # Open code samples repo

App Images

kelvin app images list       # List local images
kelvin app images remove     # Remove local image
kelvin app images unpack     # Extract image contents

App Testing

kelvin app test simulator    # Generate random test data
kelvin app test csv          # Publish data from CSV
kelvin app test generator    # Use custom data generator

MLflow Integration

kelvin app mlflow create     # Create app from MLflow model
kelvin app mlflow import     # Import MLflow model into app
kelvin app mlflow list       # List MLflow models

`workload` - Workload Management

kelvin workload list                    # List workloads
kelvin workload search <query>          # Search workloads
kelvin workload show <id>               # Show workload details
kelvin workload deploy <app> [options]  # Deploy workload
kelvin workload update <id> [options]   # Update workload
kelvin workload start <id>              # Start workload
kelvin workload stop <id>               # Stop workload
kelvin workload logs <id>               # View workload logs
kelvin workload undeploy <id>           # Delete workload

`secret` - Secret Management

kelvin secret list           # List secrets
kelvin secret create         # Create secret
kelvin secret update         # Update secret
kelvin secret delete         # Delete secret

`configuration` - CLI Configuration

kelvin configuration list    # List configurations
kelvin configuration set     # Set configuration
kelvin configuration unset   # Unset configuration

`info` - System Information

kelvin info                  # Show system and platform info

`reset` - Factory Reset

kelvin reset                 # Reset all CLI state

Configuration

Configuration is stored in ~/.config/kelvin/ (Linux/macOS) or %APPDATA%\kelvin\ (Windows).

Set persistent defaults:

kelvin configuration set json_output true    # Always output JSON
kelvin configuration set no_prompt true      # Never prompt for confirmation
kelvin configuration set verbose true        # Always verbose output

Exit Codes

Code	Meaning
0	Success
1	General error
2	Invalid usage / bad arguments
130	Interrupted (Ctrl+C)

Output Conventions

stdout: Command results (data for piping/scripting)
stderr: Progress, status, warnings, errors, debug logs

This ensures CLI output can be safely piped:

kelvin apps list --json | jq -r '.apps[0].name' | xargs kelvin apps show

Requirements

Python 3.9 - 3.13
Docker (for app build commands)

Metadata

Release files for kelvin-sdk 9.8.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for kelvin-sdk 9.8.0
File	Interpreter	ABI	Platform	Reset
kelvin_sdk-9.8.0-py3-none-any.whl 162.8 kB Oct 12, 2026	Python 3	none	any	Details

Release files / kelvin_sdk-9.8.0-py3-none-any.whl

Download URL	kelvin_sdk-9.8.0-py3-none-any.whl
Size	162.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`541a05583733a2d6fe3a046e2046dba8407500351017cfdc6b63c4495b26b7d5`
BLAKE2b-256 checksum How to use checksums	`be0b293c03b34e33a4114a678674620022ab9c8e9ef26399b768d0d98ff093e7`
Upload date	Oct 12, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.2 {"installer":{"name":"uv","version":"0.12.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`