Quick Start

From zero to AI-powered Kubernetes diagnostics in under 5 minutes.

Prerequisites

Node.js 18+ or DockerAny modern Node.js LTS release works. Docker is the fastest path.

A Kubernetes clusterEKS, GKE, AKS, k3s, and kind are all supported.

A Claude API keyBring Your Own Key (BYOK).Get a key at console.anthropic.com →

Grafana + Loki(Optional) Enables enhanced log and metric diagnostics.

Installation

Choose the method that fits your workflow. Helm is recommended for production use.

RecommendedOption A — Helm

helm repo add ki-ops https://charts.ki-ops.io
helm repo update
helm install ki-ops ki-ops/ki-ops \
  --namespace ki-ops --create-namespace \
  --set apiKey.claude=YOUR_CLAUDE_API_KEY \
  --set kubeconfig.path=/path/to/kubeconfig

Option B — Docker

docker run -d \
  --name ki-ops \
  -e CLAUDE_API_KEY=YOUR_CLAUDE_API_KEY \
  -v ~/.kube/config:/app/kubeconfig:ro \
  -p 3000:3000 \
  ghcr.io/ki-ops/ki-ops:latest

Option C — From Source

git clone https://github.com/ki-ops/ki-ops.git
cd ki-ops
cp .env.example .env  # Add your Claude API key
docker-compose up -d

Run Your First Analysis

Point KI-Ops at a namespace and let the LLM do the work. The full cluster scan typically completes in under 30 seconds.

ki-ops · production-cluster

$ki-ops analyze --namespace production

▸ Scanning namespace “production” — 24 pods, 8 deployments, 3 services

▸ kubectl get events · describe pods · top nodes

▸ Querying Loki logs (last 30 min)

⚠ pod/api-gateway-7d9f8b-xk2p CrashLoopBackOff (OOMKilled ×3)

⚠ pod/worker-job-5c6d9f-wq1r Pending — Insufficient memory on node pool

✓ All other pods healthy

LLM RECOMMENDATION

★ api-gateway: increase memory limit 256Mi → 512Mi

set HPA minReplicas 1 → 2 to prevent single-pod OOM cascades

★ worker-job: node pool autoscaler threshold too conservative (80%);

lower to 60% or add “memory-optimized” node class

PRO — run ki-ops fix --auto-pr to open a validated pull request with these changes applied automatically.

Activate Pro

Optional

The Community tier gives you the full diagnostic stack at no cost. When you are ready for auto-fix pull requests and Git integration, enter your license key to unlock Pro features.

Activate via CLI

# Enter your license key (from /#pricing) to unlock Pro features
ki-ops license activate YOUR_LICENSE_KEY

# Verify Pro features are active
ki-ops license status

Auto-fix pull requests

AI creates validated, ready-to-merge PRs from recommendations.

Git & multi-repo integration

Read, search, and modify files across all your repositories.

YAML / Helm validation

kubectl dry-run and helm template check every change before the PR opens.

Branch lifecycle management

Auto-creates branches, opens PRs, and cleans up after merge.

No license key yet? Get Pro for 250€/year →