https://github.com/linchuang2008/vigilops
AI-powered infrastructure monitoring platform
https://github.com/linchuang2008/vigilops
ai ai-ops alerting auto-remediation devops docker fastapi mcp monitoring observability react self-hosted
Last synced: 19 days ago
JSON representation
AI-powered infrastructure monitoring platform
- Host: GitHub
- URL: https://github.com/linchuang2008/vigilops
- Owner: LinChuang2008
- License: apache-2.0
- Created: 2026-02-18T01:22:17.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-03-13T02:43:51.000Z (20 days ago)
- Last Synced: 2026-03-13T09:26:42.214Z (19 days ago)
- Topics: ai, ai-ops, alerting, auto-remediation, devops, docker, fastapi, mcp, monitoring, observability, react, self-hosted
- Language: Python
- Size: 5.38 MB
- Stars: 4
- Watchers: 0
- Forks: 1
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: .github/SECURITY.md
Awesome Lists containing this project
README
# VigilOps
**Your team gets 200+ alerts daily. 80% are noise. AI fixes them while you sleep.**
[](https://github.com/LinChuang2008/vigilops)
[](https://github.com/LinChuang2008/vigilops/actions/workflows/test.yml)
[](https://github.com/LinChuang2008/vigilops/actions/workflows/docker-publish.yml)
[](https://github.com/LinChuang2008/vigilops/releases)
[](LICENSE)
[Live Demo](https://demo.lchuangnet.com/login) | [Install](#quickstart) | [Docs](#documentation) | [中文文档](README.zh-CN.md)
---
## What Makes VigilOps Different
You've tried **Grafana + Prometheus**. You know **Datadog**. They tell you *something broke*. None of them **fix it**.
VigilOps is the **first open-source AI platform** that doesn't just monitor — it **heals**:
1. **AI Analyzes** — DeepSeek reads logs, metrics, topology to find the real cause
2. **AI Decides** — Picks the right Runbook from 6 built-in auto-remediation scripts
3. **AI Fixes** — Executes the fix with safety checks and approval workflows
4. **AI Learns** — Same problems get resolved faster next time
**Global First**: World's first open-source monitoring platform with **MCP (Model Context Protocol)** integration — your AI coding assistant can query live production data directly.
---
## Quickstart
**Try Online** (no install): [demo.lchuangnet.com](https://demo.lchuangnet.com/login) — `demo@vigilops.io` / `demo123`
**Self-Host in 5 Minutes:**
```bash
git clone https://github.com/LinChuang2008/vigilops.git && cd vigilops
cp .env.example .env # Add your DeepSeek API key
docker compose up -d
# Open http://localhost:3001 — first account becomes admin
```
> On first startup, the backend auto-creates 37 tables, 5 alert rules, and 8 dashboard components.
---
## Feature Comparison
| Feature | VigilOps | Nightingale | Prom+Grafana | Datadog | Zabbix |
|---------|:--------:|:-----------:|:------------:|:-------:|:------:|
| AI Root Cause Analysis | Built-in | - | - | Enterprise | - |
| Auto-Remediation | 6 Runbooks | - | - | Enterprise | - |
| MCP Integration | **First** | - | - | Early | - |
| Self-Hosted | Docker | K8s/Docker | Complex | SaaS | Yes |
| Cost | **Free** | Free/Ent | Free | $$$ | Free/Ent |
| Setup Time | **5 min** | 30 min | 2+ hrs | 5 min | 1+ hr |
**Sweet Spot**: Small-to-medium teams who want AI-powered ops without enterprise licensing costs.
> **Honest disclaimer**: We're early stage. For mission-critical systems at scale, use proven solutions. For teams ready to experiment with AI ops, we're your best bet.
---
## How It Works
```
Alert Fires AI Diagnosis Auto-Fix Resolved
┌──────────┐ ┌──────────────┐ ┌────────────────┐ ┌────────────┐
│ Disk 95% │────>│ "Log rotation│────>│ log_rotation │───>│ Disk 60% │
│ on prod │ │ needed on │ │ runbook starts │ │ Fixed in │
│ server │ │ /var/log" │ │ safely │ │ 2 minutes │
└──────────┘ └──────────────┘ └────────────────┘ └────────────┘
```
**6 Built-in Runbooks**: `disk_cleanup` | `service_restart` | `memory_pressure` | `log_rotation` | `zombie_killer` | `connection_reset`
---
## Screenshots
**Dashboard** — Real-time metrics across all hosts
**AI Alert Analysis** — Root cause + recommended action
---
## MCP Integration — Global Open Source First
Your AI assistant (Claude Code, Cursor) queries live production data via MCP:
```bash
# Enable in backend/.env
VIGILOPS_MCP_ENABLED=true
VIGILOPS_MCP_PORT=8003
VIGILOPS_MCP_TOKEN=your-secret-token
```
**5 MCP Tools**: `get_servers_health` | `get_alerts` | `search_logs` | `analyze_incident` | `get_topology`
Ask your AI: *"Show all critical alerts on prod-server-01"* / *"Analyze last night's CPU spike"* / *"Search for OOM errors in the past 2 hours"*
---
## Installation
### Prerequisites
- Docker 20+ & Docker Compose v2+
- 4 CPU / 8 GB RAM (build) / 2 GB RAM (runtime)
### Environment Variables
| Variable | Required | Description |
|----------|:--------:|-------------|
| `POSTGRES_PASSWORD` | Yes | Database password |
| `JWT_SECRET_KEY` | Yes | `openssl rand -hex 32` |
| `AI_API_KEY` | Yes | DeepSeek API key |
| `AI_AUTO_SCAN` | Rec. | Auto-analyze alerts (`true`) |
See [docs/installation.md](docs/installation.md) for full guide.
---
## Tech Stack
| Layer | Technology |
|-------|------------|
| Frontend | React 19, TypeScript, Vite, Ant Design 6, ECharts 6 |
| Backend | Python 3.9+, FastAPI, SQLAlchemy, AsyncIO |
| Database | PostgreSQL 15+, Redis 7+ |
| AI | DeepSeek API (configurable LLM) |
| Deploy | Docker Compose |
---
## Documentation
[Getting Started](docs/getting-started.md) | [Installation](docs/installation.md) | [User Guide](docs/user-guide.md) | [API Reference](docs/api-reference.md) | [Architecture](docs/architecture.md) | [Contributing](CONTRIBUTING.md) | [Changelog](CHANGELOG.md)
---
## Contributing
We need contributors who understand alert fatigue firsthand. See [CONTRIBUTING.md](CONTRIBUTING.md).
```bash
cp .env.example .env
docker compose -f docker-compose.dev.yml up -d
pip install -r requirements-dev.txt
cd frontend && npm install
```
---
## Community
- [GitHub Discussions](https://github.com/LinChuang2008/vigilops/discussions)
- [Report a Bug](https://github.com/LinChuang2008/vigilops/issues/new)
- Email: [lchuangnet@lchuangnet.com](mailto:lchuangnet@lchuangnet.com)
---
[Apache 2.0](LICENSE) — Use it, fork it, ship it commercially.
[](CONTRIBUTING.md)