Apache 2.0 · Free & Open Source

Your Kubernetes cluster
has an AI debugger now.

KubeAstra investigates broken pods, finds the root cause with AI, and recovers your cluster. 32 kubectl tools. One agent. Zero guesswork.

View on GitHub Watch Demo
kubectl prometheus logs events topology
kubeastra investigate
$ kubeastra investigate --pod api-gateway --ns production

kubectl Collecting pod status and events...
metrics Pulling container resource usage...
logs Reading current + previous container logs...
events Correlating cluster events timeline...
analyze Running AI root-cause analysis...

Root cause: OOMKilled. Container RSS 142Mi exceeded limit 128Mi.
Trigger: Memory leak introduced in v2.3.1 (deployed 47 min ago).
Recommended: Rollback to v2.3.0 · blast radius: 2 services
Capabilities

Everything you need to debug K8s

32 kubectl investigation tools orchestrated by AI. From diagnosis to recovery, in seconds instead of minutes.

32 Investigation Tools

Pod diagnostics, log analysis, event correlation, node health, resource quotas, network policies, PVC status, and more.

AI Root-Cause Analysis

Cross-references logs, events, and resource metrics to pinpoint exactly what went wrong and why. Powered by Google Gemini.

Automated Recovery

Pod restarts, deployment rollbacks, HPA scaling. Human-in-the-loop approval by default, or fully automated if you choose.

Web UI Dashboard

Next.js interface that shows investigations in real time. Watch the agent work, review findings, and approve actions.

MCP Server for IDEs

Model Context Protocol server exposes all 32 tools to AI-powered editors. Debug clusters from Cursor or VS Code.

Fully Self-Hosted

Deploy inside your cluster with Helm. Your data never leaves your infrastructure. No SaaS, no callbacks, no telemetry.

Workflow

How KubeAstra works

From broken pod to root cause in seconds, not minutes.

01

Detect

Point KubeAstra at a failing pod, or let it watch your cluster. It picks up CrashLoopBackOff, OOMKilled, ImagePullBackOff, pending pods, and other failure states.

02

Investigate

The agent runs kubectl tools automatically: pod describe, logs (current and previous), events, node status, resource usage, deployment history, network policies, PVC mounts, and more.

03

Analyze

AI processes all collected data together, cross-referencing signals across multiple resources to identify the root cause with confidence levels and supporting evidence.

04

Recover

Based on the analysis, KubeAstra recommends and can execute recovery actions: pod restarts, deployment rollbacks, or HPA scaling. Human approval required by default.

See It In Action

Demo

Watch KubeAstra investigate a failing pod, find the root cause, and suggest recovery.

Click to play demo
Built With

Tech Stack

Python
FastAPI
Next.js
TypeScript
Google Gemini
Kubernetes
Helm
MCP Server

Stop debugging the same way every time.

KubeAstra is free, open source, and ready to deploy. Star the repo, try it out, or contribute.