Skip to content

DsThakurRawat/Argus

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

74 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Argus

Autonomous, Multi-Provider Cloud SRE & AI Monitoring Assistant

License Python Version Multi-Provider AI CI/CD

Your intelligent, self-healing cloud infrastructure partner.


Overview

Argus is an advanced, autonomous multi-provider SRE (Site Reliability Engineering) agent designed to act as your always-on infrastructure watchdog. By leveraging the power of 100+ AI providers (including OpenAI, Anthropic, Google Gemini, Ollama, and more), Argus continuously monitors your cloud logs, detects anomalies, and actively remediates issues without human intervention.

When critical events strike, Argus doesn't just send an alert—it instantly triages the error via Discord/Slack/Telegram, creates a structured diagnosis, generates code fixes using a unified system, and proposes concrete remediation steps via automated GitHub Pull Requests.

Key Features

  • Multi-Provider AI LLM Architecture
    • Seamlessly switch between OpenAI, Anthropic, Gemini, Grok, and local models.
    • Built-in circuit breakers, cost-aware routing, and automatic fallback mechanisms.
  • Enterprise & Modern PaaS Log Ingestion
    • Pluggable adapters for GCP Pub/Sub, AWS CloudWatch, Azure, and local files.
    • Native HTTP Webhook Log Drains for Vercel, Render, Railway, and Cloudflare.
  • Interactive Terminal UI
    • Fully interactive CLI wizard for configuration. No more editing YAML files manually.
    • Arrow-key menus for selecting AI providers, Cloud environments, and Notification Bots.
  • 4-Layer Pattern Detection
    • Identifies cascade failures, resource exhaustion, and service degradations.
    • Utilizes sliding window logic and ML-based similarity caching for minimal latency.
  • Secure Code Generation
    • Domain-specific code generators for database, API, and security fixes.
    • Pre-processing validation and PII/credential sanitization built-in.
  • Automated Remediation
    • Self-healing workflows that package fixes into automated PRs ready for human review.

System Architecture

Argus employs a modular, event-driven design to ensure high availability and redundancy.

graph TD
    subgraph Ingestion ["Log Ingestion"]
    A["AWS CloudWatch"] --> D["Ingestion Manager"]
    B["GCP Pub/Sub"] --> D
    C["Kubernetes"] --> D
    end
    subgraph Core ["AI Core"]
    D --> E["Triage & Pattern Detection"]
    E --> F{"Multi-Provider LLM Router"}
    F --> |Analysis| G["Root Cause Analyzer"]
    F --> |Fixes| H["Code Generator"]
    end
    subgraph Remediation ["Remediation"]
    G --> I["Automated PR Builder"]
    H --> I
    I --> J["GitHub / GitLab"]
    end
Loading

Note: For a complete deep-dive into the data flows and provider routing, see our System Architecture Overview.

Documentation

Dive deeper into Argus's internal engines and subsystems:

Component Description
Architecture Deep dive into the core SRE loop and data flows.
Log Ingestion Managing and configuring enterprise log adapters.
Pattern Detection Sliding window logic and anomaly classification.
Prompt Generation "AI teaching AI" meta-prompting strategies.
Code Generation Multi-level validation pipeline for robust code fixes.

Looking for operations and deployment? Check out our Quickstart, Setup Guide, and Deployment Guide.

Quick Start (New CLI!)

Get Argus up and running in your environment in under 60 seconds without touching a single YAML file.

1. Global Installation (Recommended)

You can install Argus as a standalone global terminal command via our secure setup script:

curl -sSL https://raw.githubusercontent.com/DsThakurRawat/Argus/main/install.sh | bash

2. Interactive Setup

Run the Argus interactive dashboard from anywhere:

argus run

You will be greeted by our retro terminal UI. Just use your arrow keys to select:

  1. Your Cloud Platform (AWS, GCP, Vercel, Render, etc.)
  2. Your LLM Provider (OpenAI, Gemini, Anthropic, Groq, Ollama)
  3. Your Notification Channels (Slack, Discord, Telegram)

Argus will automatically mask and store your API keys locally and instantly start monitoring your logs!


Manual Installation (For Development)

If you wish to develop or modify Argus:

git clone https://github.com/DsThakurRawat/Argus.git
cd Argus
uv sync
uv run argus run

Contributing

Argus is built for the community. We welcome all contributions—from bug fixes to new LLM provider integrations! Please read our Development & Contributing Guide for local testing patterns, code style, and PR submission workflows.

License

Argus is open-source software licensed under the MIT License.


Built with by the Argus Contributors.

About

A multi-agent AI system for cloud infrastructure monitoring, incident triage, root cause analysis, and patch generation

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages