git404hub

what is aegil fr?

pro-deploy/aegil — explained in plain English

Analysis updated 2026-05-18

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

tl;dr

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.

vibe map

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 make with this?

VIBE 1

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

VIBE 2

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

VIBE 3

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

VIBE 4

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

what's the stack?

PythonKubernetesFastAPILokiGrafana

how it stacks up fr

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 i run it?

Difficulty · hard time til it works · 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.

in plain english

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.

prompts (copy fr)

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 fr?

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.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.