Quick Start

  1. 1

    Install the KDCube CLI

    # Recommended: pipx (isolated installation)
pipx install kdcube-cli

# Or with pip
pip install kdcube-cli

    Prerequisites: Python 3.11+, Docker, Git.

  2. 2

    Run the setup wizard

    kdcube-setup

    The wizard is fully interactive — you can enter everything manually, or point it at deployment descriptors and it applies them automatically: assembly.yaml · gateway.yaml · bundles.yaml. Choose release-latest → answer yes to "Run docker compose now?" — no local build needed. Creates ~/.kdcube/kdcube-runtime/, pulls images, starts Docker Compose. Secrets are injected into the kdcube-secrets service at setup time — never written to disk.

    KDCube CLI setup wizard
  3. 3

    Open the UI

    http://localhost:${KDCUBE_UI_PORT}/chatbot/chat

    You're now running a full KDCube stack with the built-in example bundle set.

Setup Flow

CLI setup flow diagram
Setup Flow Sequential steps of KDCube CLI setup wizard from install through configuration Descriptors ×5 assembly · secrets gateway · bundles kdcube-setup CLI wizard Workdir + Env ~/.kdcube/kdcube-runtime Docker Compose full stack up Platform Live ✓ ready for bundles

Workdir Layout

~/.kdcube/kdcube-runtime/
├─ config/
│  ├─ .env                           # Base Docker Compose env
│  ├─ assembly.yaml                  # Platform version, auth type, domain
│  ├─ bundles.yaml                   # Bundle definitions        ← edit this
│  ├─ gateway.yaml                   # Rate limits, circuit breaker
│  ├─ install-meta.json              # CLI install metadata
│  ├─ frontend.config.*.json         # UI auth config
│  ├─ nginx_proxy.conf               # Nginx reverse proxy
│  └─ nginx_ui.conf                  # Nginx UI config
├─ data/
│  ├─ bundle-storage/                # Per-bundle persistent storage
│  ├─ bundles/                       # Bundle source cache
│  ├─ exec-workspace/                # Code execution sandboxes
│  ├─ kdcube-storage/                # Conversations, artifacts, files
│  ├─ nginx/                         # Nginx runtime data
│  ├─ postgres/                      # Database volume
│  └─ redis/                         # Redis persistence
└─ logs/                             # Service logs

Secrets are never stored on disk — they are injected into kdcube-secrets at setup time and resolved in-memory at runtime.

Full CLI reference: kdcube_cli/README.md