whatisgithub

What is aegil?

pro-deploy/aegil — explained in plain English

Analysis updated 2026-05-18

111PythonAudience · ops devopsComplexity · 5/5Setup · hard

In one sentence

An autonomous Kubernetes SRE agent that observes cluster logs and metrics, diagnoses problems, and can safely fix them through chat, with built in guardrails against risky actions.

Mindmap

mindmap
  root((Aegil))
    What it does
      Watches Kubernetes clusters
      Diagnoses incidents
      Chats and repairs issues
    Tech stack
      Python and FastAPI
      Loki and Grafana
      SetFit classifier
    Use cases
      Automated incident diagnosis
      Safe guarded remediation
      Audit trail logging
    Audience
      DevOps engineers
      SRE teams

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Automatically diagnose Kubernetes incidents from logs, metrics, and traces.

USE CASE 2

Chat with an AI agent that can inspect and repair cluster and node issues.

USE CASE 3

Run safe, automatic remediation for routine problems while requiring approval for risky ones.

USE CASE 4

Keep a full audit trail of every diagnostic and repair action taken on a cluster.

What is it built with?

PythonKubernetesFastAPILokiGrafana

How does it compare?

pro-deploy/aegil2417467487-hub/trend2video-prostanleynull/autohunter
Stars111111111
LanguagePythonPythonPython
Setup difficultyhardmoderatemoderate
Complexity5/54/5
Audienceops devopsvibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1day+

Requires a Kubernetes cluster, building and publishing container images, a language model endpoint, and manual review of manifests for your environment.

No license information is stated in the visible README, so reuse and redistribution terms are unclear.

So what is it?

Aegil is a tool that watches over a Kubernetes cluster and helps fix problems on it, acting like an automated site reliability engineer. Instead of an engineer manually digging through logs and dashboards when something breaks, Aegil connects to the cluster, the logs, and the monitoring systems, figures out what is actually wrong, and can take action to repair it, all while the person operating it just chats with it in plain language. Under the hood, a deterministic pipeline reads log lines, gathers facts, runs a set of built in checks, and builds a conclusion where every claim is backed by an exact quote from a real log line rather than a guess. A small trained classifier helps sort routine requests from harder ones that get escalated to a larger language model. The language model itself does not have free rein: a separate rule based classifier decides how risky any action is, so the model cannot skip past a required confirmation step for anything destructive, like deleting data or removing storage volumes. The project ships as four separate services plus an optional set of open source monitoring tools. One service runs with elevated access on cluster nodes to inspect disk space, processes, and memory and to clean things up when needed. Another is the chat panel where an operator talks to the agent and reviews an audit trail of everything it has done. A safety mode called dry run is on by default, meaning the agent will observe and suggest but not act until autonomous mode is explicitly turned on, and even then, safe fixes happen automatically while destructive ones always wait for a human to confirm. Setting it up means building container images, applying Kubernetes manifests, and creating secrets for authentication, and it currently expects the operator to review cluster specific details like storage classes before deploying. The project describes itself as an early extraction from a larger platform, version 0.1.0, with the core pieces tested but some parts, like a Helm chart and full configuration options, still incomplete.

Copy-paste prompts

Prompt 1
Walk me through deploying Aegil onto my Kubernetes cluster step by step.
Prompt 2
Explain how Aegil's deterministic root cause analysis pipeline builds its verdicts.
Prompt 3
Show me how the dry run and autonomous modes differ and how to switch safely.
Prompt 4
Help me set up the node-agent and panel secrets needed for this project.

Frequently asked questions

What is aegil?

An autonomous Kubernetes SRE agent that observes cluster logs and metrics, diagnoses problems, and can safely fix them through chat, with built in guardrails against risky actions.

What language is aegil written in?

Mainly Python. The stack also includes Python, Kubernetes, FastAPI.

What license does aegil use?

No license information is stated in the visible README, so reuse and redistribution terms are unclear.

How hard is aegil to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is aegil for?

Mainly ops devops.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.