kubectl-ai  by GoogleCloudPlatform

AI-powered Kubernetes CLI assistant

created 6 months ago
6,572 stars

Top 7.9% on sourcepulse

GitHubView on GitHub
1 Expert Loves This Project
Project Summary

This project provides an AI-powered assistant for interacting with Kubernetes clusters directly from the terminal. It targets Kubernetes users, developers, and operators seeking to streamline cluster management and troubleshooting by leveraging natural language queries. The primary benefit is faster, more intuitive cluster operations without needing to memorize complex kubectl commands.

How It Works

The tool translates natural language prompts into executable kubectl commands. It supports multiple LLM providers, including Google's Gemini, OpenAI, and local models via Ollama and llama.cpp. Users can interact conversationally or provide single commands. The underlying mechanism involves parsing the user's intent, selecting the appropriate LLM and model, generating the kubectl command, executing it, and presenting the results with explanations.

Quick Start & Requirements

  • Installation: Download binary from releases, make executable, and add to $PATH.
  • Prerequisites: kubectl installed and configured.
  • API Keys: Required for cloud-based LLMs (Gemini, OpenAI).
  • Local LLMs: Requires Ollama or llama.cpp to be running and models pulled.
  • Docs: Kubernetes Plugins

Highlighted Details

  • Supports Gemini, Vertex AI, Azure OpenAI, OpenAI, Ollama, and llama.cpp LLM providers.
  • Offers interactive chat mode for contextual conversations.
  • Can be used as a kubectl plugin (kubectl ai).
  • Includes k8s-bench for evaluating LLM performance on Kubernetes tasks.

Maintenance & Community

This is not an officially supported Google product. It is not eligible for the Google Open Source Software Vulnerability Rewards Program.

Licensing & Compatibility

The README does not specify a license.

Limitations & Caveats

The project is explicitly stated as "not an officially supported Google product" and is not eligible for vulnerability rewards, suggesting a community-driven, potentially less formally supported status. The license is not specified, which may pose compatibility issues for commercial or closed-source use.

Health Check
Last commit

1 day ago

Responsiveness

1 day

Pull Requests (30d)
39
Issues (30d)
24
Star History
6,289 stars in the last 90 days

Explore Similar Projects

Feedback? Help us improve.