AI-SRE: Autonomous Linux Troubleshooting Agent 🛡️

AI-SRE is a high-signal, premium, local-running diagnostics agent that automates incident response, diagnoses system failures, and recommends safe, audited Bash resolution scripts.

🚀 Key Features

• Structured Diagnostic Tools: Python tools executing real systems analysis (Disk metrics, Systemd loops, networking socket bindings, process hogs).
• API & Mock Reasoning Loop: Run real-time agent chains using Google Gemini or OpenAI APIs, or execute offline with Simulated Interactive SRE Mode.
• Stunning Interfaces: Beautiful interactive Streamlit Web Dashboard and colorful command-line interface (rich-rendered CLI).

---

🏗️ Architecture Design

graph TD
    User([User Issue Query]) --> UI[Streamlit / CLI UI]
    UI --> Agent[AI-SRE Reasoning Agent]
    Agent --> Mock[Interactive Mock Simulator]
    Agent --> LLM[Google Gemini / OpenAI Client]
    Agent --> Registry[SRE Tools Registry]
    Registry --> Disk[Disk Audit df -h]
    Registry --> Systemd[Systemctl Services failed]
    Registry --> Port[Socket Listeners ss/netstat]
    Agent --> Analysis[Root Cause & Safe Bash Fix]
    Analysis --> User

Loading

---

🛠️ Getting Started

1. Install Dependencies

pip install -r requirements.txt

2. Configure Environment (Optional for API keys)

Create a .env file in the root directory:

GEMINI_API_KEY=your_gemini_key
# OR
OPENAI_API_KEY=your_openai_key

3. Launch the Interfaces

• Run Streamlit Web UI:

  streamlit run app.py

• Run Interactive CLI:

  python cli.py