Apppublic

Reenu90/devops-ai-agent

sourceHugging Facemitupdated 5mo agoView on Hugging Face

0likes

App README

⚙️ DevOps AI Agent

A Gemini-powered AI assistant for DevOps and SRE engineers — chat, explain commands, analyse logs, and generate runbooks.

![Live Demo](https://reenu90-devops-ai-agent.hf.space)

🚀 Live Demo

Try it now — no install needed: 👉 reenu90-devops-ai-agent.hf.space

✨ Features

Tool	Description
💬 AI Chat	Ask anything about Kubernetes, GCP, Terraform, CI/CD — powered by Gemini 2.5 Flash
🖥️ Command Explainer	Paste any kubectl / terraform / docker / gcloud command → get a full plain-English breakdown
📋 Log Analyser	Paste raw logs → root cause, severity, and step-by-step fix
📖 Runbook Generator	Describe an incident → production-ready runbook you can download as Markdown

🏗️ Architecture

User Input
    │
    ├── Chat query
    │       └──▶ Gemini 2.5 Flash
    │                   └──▶ Streamed response
    │
    ├── DevOps command
    │       └──▶ Command Explainer prompt builder
    │                   └──▶ Gemini 2.5 Flash
    │                               └──▶ Flag-by-flag breakdown
    │
    ├── Raw logs
    │       └──▶ Log Analyser prompt builder
    │                   └──▶ Gemini 2.5 Flash
    │                               └──▶ Root cause + fix plan
    │
    └── Incident description
            └──▶ Runbook Generator prompt builder
                        └──▶ Gemini 2.5 Flash
                                    └──▶ Downloadable .md runbook

🚀 Run Locally

1. Clone the repo

bash

git clone https://github.com/Reenu90/devops-ai-agent.git
cd devops-ai-agent

2. Set up virtual environment

bash

python3.11 -m venv venv
source venv/bin/activate

3. Install dependencies

bash

pip install -r requirements.txt

4. Add your Gemini API key

bash

cp .env.example .env
# Edit .env and add your key from https://aistudio.google.com/app/apikey

5. Run the app

bash

python -m streamlit run app.py

🔑 Getting a Free Gemini API Key

1.Go to Google AI Studio
2.Sign in with your personal Google account
3.Click Create API Key in new project
4.Copy it into your .env file

🗂️ Project Structure

devops-ai-agent/
├── app.py                      # Streamlit UI
├── requirements.txt
├── .env.example
├── src/
│   ├── __init__.py
│   └── agent.py                # Gemini 2.5 Flash integration
└── tools/
    ├── __init__.py
    ├── command_explainer.py    # Prompt builder for command breakdowns
    ├── log_analyser.py         # Prompt builder for log diagnosis
    └── runbook_generator.py    # Prompt builder for runbook generation

🛠️ Tech Stack

Layer	Technology
LLM	Google Gemini 2.5 Flash
UI	Streamlit
Hosting	Hugging Face Spaces
Auth	Google AI Studio API key

🔮 Roadmap

—[ ] GCP Monitoring integration — pull real logs directly from Cloud Logging
—[ ] Terraform plan analyser — paste a terraform plan output → get risk assessment
—[ ] Multi-turn incident response mode
—[ ] MCP server — expose tools as a standard Model Context Protocol server
—[ ] Slack bot integration
—[ ] Export runbooks to Confluence

👩‍💻 Author

Built by Reenu Jacob — Google Cloud Professional ML Engineer LinkedIn · GitHub

📄 License

MIT