Home

KubeIntellect Wiki

Human-governed AI SRE for Kubernetes — chat with your cluster in plain English; it diagnoses with live evidence and only acts after you approve.

This wiki is the community map. Deep, always-current reference lives in the repo docs — this wiki links you there and adds the narrative: how the project is designed, why, and how to help.

Start here

• 🚀 Website & live demo — try it in the browser, zero install
• 📦 Install paths — CLI, local Kind, Docker, existing cluster
• 🧑‍💻 Contributing — clone → PR
• 💬 Discussions — questions, ideas, RFCs

Wiki pages

Get started

• Installing KubeIntellect — every install path, and what each one actually gives you today
• Troubleshooting — real errors and what they mean
• FAQ — the questions everyone asks

Understand

• Architecture Overview — how a question becomes an answer (and an approved action)
• The Safety Model — the human-in-the-loop invariant, RBAC, prompt-injection defense
• KubeIntellect vs k8sgpt vs HolmesGPT — an honest comparison, including where we are weaker
• Version Lineage — v1 → v4, and why the project keeps re-architecting
• Glossary — coordinator, chokepoint, flight recorder, playbook…

Answered questions — each written against the current code, and the fastest way to judge fit

• What stops it deleting something important? — the four safety layers, and where the gate is only procedural
• What data leaves my cluster? — including the part that surprises people: redaction covers storage, not the prompt path
• Is it production-ready? — an honest staged-adoption answer, not a yes
• vs k8sgpt / HolmesGPT — including where they are better

Take part

• Your First Contribution — clone to merged PR, no cluster required
• Community & Support — where to ask, how issues are triaged, how to get counted

✅ Installing right now? pip install kube-q is current (1.5.0, all subcommands) and so is pip install kubeintellect (2.2.0). Verified 2026-08-10 — see Installing KubeIntellect. If you followed the old git+https://… workaround, switch back to pip install --upgrade kube-q.

Get involved in 30 seconds

Pick whichever costs you least — all three are real contributions:

• 🙋 Running it anywhere? Say so on #51. Even "Kind on my laptop" counts, and listed environments are the ones that get tested against.
• 👍 Want something built? React on the items in #52. Reaction counts are the project's only prioritisation signal, and they genuinely reorder the roadmap.
• 🛠 Want to write code? Start with a good first issue — each one names the file, the line, and the command that proves you fixed it.

What makes it different

	KubeIntellect	Read-only AI diagnostics (e.g. k8sgpt)	Raw kubectl + dashboards
Natural-language Q&A	✅	✅	❌
Correlates kubectl + Prometheus + Loki	✅	Partial	Manual
Performs cluster actions	✅ (approval-gated)	❌	✅ (unguarded)
Human-in-the-loop gate + RBAC	✅	n/a	❌

The research behind it

KubeIntellect's original architecture is described in a peer-reviewed paper:

Seyedkazemi Ardebili, M., & Bartolini, A. (2026). KubeIntellect: A Modular LLM-Orchestrated Agent Framework for End-to-End Kubernetes Management. Journal of Grid Computing, 24(3). https://doi.org/10.1007/s10723-026-09837-6