> ## Documentation Index
> Fetch the complete documentation index at: https://docs.simplismart.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Command-line interface reference for Simplismart

The Simplismart CLI provides command-line access to manage model repositories, deployments, and secrets.

## Installation

After installing the SDK, the CLI is available as the `simplismart` command:

```bash theme={null}
pip install simplismart-sdk
```

## Global Options

These options apply to all CLI commands:

```bash theme={null}
simplismart [global options] <command> [subcommand] [options]
```

| Option              | Description                   | Default                                      |
| ------------------- | ----------------------------- | -------------------------------------------- |
| `--pg-token TOKEN`  | Playground token              | Falls back to `SIMPLISMART_PG_TOKEN` env var |
| `--base-url URL`    | API base URL                  | `https://api.app.simplismart.ai`             |
| `--timeout SECONDS` | Request timeout               | `300`                                        |
| `--trace-id ID`     | Optional trace/correlation ID | Generated per request                        |

***

## Quick Reference

| Task                                | Command                                                                                                                                                                                                                                                                                |
| ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| List model repos                    | `simplismart model-repos list`                                                                                                                                                                                                                                                         |
| Create model repo (container)       | `simplismart model-repos create-container --name <name> --source-type docker_hub --runtime-gpus 1 --source-secret <SECRET_ID> --registry-path <path> --docker-tag <tag>`                                                                                                               |
| Create model repo (private compile) | `simplismart model-repos create-private-compile --name <name> --source-type huggingface --source-url <path> --model-class <class> --accelerator-type <type> --model-config @model_config.json --optimisation-config @optimisation_config.json --pipeline-config @pipeline_config.json` |
| List deployments                    | `simplismart deployments list`                                                                                                                                                                                                                                                         |
| Create deployment                   | `simplismart deployments create --model-repo <ID> --org $ORG_ID --gpu-id nvidia-h100 --name <name> --min-pod-replicas 1 --max-pod-replicas 2 --autoscale-config @config.json`                                                                                                          |
| Stop deployment                     | `simplismart deployments stop --deployment-id <ID>`                                                                                                                                                                                                                                    |
| Start deployment                    | `simplismart deployments start --deployment-id <ID>`                                                                                                                                                                                                                                   |
| Delete deployment                   | `simplismart deployments delete --deployment-id <ID>`                                                                                                                                                                                                                                  |
| Create secret                       | `simplismart secrets create --org-id $ORG_ID --name <name> --secret-type docker_hub --data @data.json`                                                                                                                                                                                 |
| List secrets                        | `simplismart secrets list --org-id $ORG_ID`                                                                                                                                                                                                                                            |