Skip to content
Mohsen Seyedkazemi Ardebili edited this page Aug 7, 2026 · 1 revision

FAQ

Does it change my cluster automatically? No. Read-only queries run immediately; any mutating action (scale/restart/delete/patch) pauses for explicit human approval, subject to RBAC. See The Safety Model.

Do I need a cluster to try it? No. Use the browser demo (read-only) or the read-only kube-q CLI (pip install kube-q). For full features, kubeintellect init creates a local Kind cluster for you (Docker is the only prerequisite).

What LLM providers are supported? OpenAI and Azure OpenAI out of the box; v4 also supports additional providers via configuration (and there's an OpenAI-compatible base-URL path). First-class local/self-hosted support is an open help wanted item.

Which version should I use? v4/ — the current, actively developed implementation. See Version Lineage.

How is this different from k8sgpt / read-only AI diagnostics? Those diagnose but can't act. KubeIntellect can also act — scale, restart, delete — but only after explicit human approval, gated by RBAC. It's also not a replacement for your observability stack or a GitOps pipeline; it queries the tools you already run and pauses before changing anything.

Is it really open source? What's the license? Yes. KubeIntellect is dual-licensed under AGPL-3.0-or-later or a commercial license. Self-host and modify freely under the AGPL; a commercial license is available for closed/SaaS use. See LICENSING.md.

How do I contribute? Start with CONTRIBUTING.md and a good first issue. Questions → Discussions.

Where do I report a security issue? Privately — see SECURITY.md. Please don't open a public issue for vulnerabilities.

How do I cite KubeIntellect? See CITATION.cff or the paper.

Clone this wiki locally