ongrid

# <img src="web/public/ongrid-logo.svg" alt="" width="40" align="absmiddle" style="vertical-align: middle;" /> Ongrid > **An ops AI Agent that understands your infrastructure, finds the root cause, and fixes it — right from Slack or Telegram.** *Metrics · logs · traces · topology blast-radius · root-cause correlation · remote execution · alert-driven auto-investigation · RAG knowledge & code search · specialist agents & skills.* [](https://goreportcard.com/report/github.com/ongridio/ongrid) [](https://github.com/ongridio/ongrid/releases/latest) [](go.mod) [](https://www.gnu.org/licenses/agpl-3.0.html) [](#features) [](CONTRIBUTING.md) [](https://t.me/ongridai) [](https://join.slack.com/t/ongrid-co/shared_invite/zt-400skx7hz-WU1nmF1XVYH4S3Q1NfWrbw) <p> <a href="https://trendshift.io/repositories/48061?utm_source=repository-badge&amp;utm_medium=badge&amp;utm_campaign=badge-repository-48061" target="_blank" rel="noopener noreferrer"> <img src="https://trendshift.io/api/badge/repositories/48061" alt="Ongrid on Trendshift" width="250" height="55" /> </a> </p> English | [简体中文](./README_ZH.md) | [日本語](./README_JA.md) | [한국어](./README_KO.md) | [Español](./README_ES.md) | [Français](./README_FR.md) | [Deutsch](./README_DE.md) | [Português](./README_PT.md) | [Русский](./README_RU.md) --- <p align="center"> <img src="docs/assets/demo.gif" alt="Ongrid demo" width="100%" /> </p> <p align="center"> <img src="docs/assets/kubernetes-release-banner.png" alt="Kubernetes lifecycle management" width="100%" /> <br /> <strong>☸️ Kubernetes lifecycle management is now available</strong><br /> _{Enroll clusters through Edge, inspect workloads and events, manage upgrades, and connect Kubernetes resources to topology.} </p> <div align="center"> [Features](#features) • [Install](#install) • [Integrations](#integrations) • [License](#license) </div> ## Features - 🤖 **Coordinator + Specialist agents** — coordinator dispatches to SRE / network / DB sub-agents - 🚨 **Auto-investigate on alert** — investigator spawns an RCA worker, writes the cause back to chat - 🔍 **Root-cause RCA** — walks topology, correlates m/l/t, pins the "why" to a source-code line - 🔒 **Zero inbound ports** — edge dials out; no port 22 / 80 / 443 on hosts - 💻 **Browser SSH** — reverse-tunnel shell into any host; no keys, no jumpbox, all audited - 🐳 **Self-host in one command** — `install.sh` brings up the full stack - 📊 **Built-in observability** — Prometheus + Loki + Tempo + Grafana wired; the agent writes the queries - 🧠 **Bring your own model** — Anthropic / OpenAI / GLM / DeepSeek / Gemini / Kimi, hot routing - 💬 **Two-way IM channels** — Slack / Telegram / Larksuite / DingTalk / WeCom, per-channel locale - 🛠️ **Read-only host tools** — bash sandbox + 26+ inspection tools; every call audited - ☸️ **Kubernetes lifecycle** — enroll clusters, inspect workloads and events, manage upgrades, and mirror Kubernetes resources into topology - 🌐 **Network device management** — discover neighbors from Edge hosts, verify with SNMP, poll interfaces, and map host-to-network-device links ## Install Download the latest release for your server architecture (`linux-amd64` or `linux-arm64`), extract it, and run the installer (Ubuntu 22.04+, Debian 12+, RHEL/Rocky 9): Choose the command for your server architecture: **AMD64** ```bash wget https://github.com/ongridio/ongrid/releases/download/v0.17.6/ongrid-v0.17.6-linux-amd64.tar.xz tar -xf ongrid-v0.17.6-linux-amd64.tar.xz && cd ongrid-v0.17.6-linux-amd64 sudo ./install.sh ``` **ARM64** ```bash wget https://github.com/ongridio/ongrid/releases/download/v0.17.6/ongrid-v0.17.6-linux-arm64.tar.xz tar -xf ongrid-v0.17.6-linux-arm64.tar.xz && cd ongrid-v0.17.6-linux-arm64 sudo ./install.sh ``` **🇨🇳 Mainland China** — if GitHub is slow, use the matching CDN mirror URL instead: ```bash # AMD64 wget https://ongrid.cloud/dl/ongrid-v0.17.6-linux-amd64.tar.xz # ARM64 wget https://ongrid.cloud/dl/ongrid-v0.17.6-linux-arm64.tar.xz ``` ## Product Tour ### Root Cause Analysis <p align="center"> <img src="docs/assets/readme-tour/user-20260707-agent-write-gate.png" alt="Root cause analysis report" width="100%" /> </p> Start from an operator question or alert, collect topology and device context, and produce an evidence-backed analysis with concrete next steps. ### Workflow Builder <p align="center"> <img src="docs/assets/readme-tour/user-20260707-workflow-editor.png" alt="Workflow builder" width="100%" /> </p> Wire triggers, agents, tools, conditions, and notifications into repeatable automations that stay editable and reviewable. ### Skills Catalog <p align="center"> <img src="docs/assets/readme-tour/user-20260707-skills-catalog.png" alt="Skills catalog" width="100%" /> </p> Show the tools agents can call, with clear descriptions and a visible inventory for operators. ### MCP Servers <p align="center"> <img src="docs/assets/readme-tour/user-20260707-mcp-servers.png" alt="MCP servers" width="100%" /> </p> Register external MCP servers and expose their tools to chat agents and workflows with clear runtime and trust boundaries. ### Knowledge Vault <p align="center"> <img src="docs/assets/readme-tour/user-20260707-knowledge-vault.png" alt="Knowledge vault" width="100%" /> </p> Index runbooks, notes, incident history, and repositories so both humans and agents can search the same operational context. ### Artifacts Center <p align="center"> <img src="docs/assets/readme-tour/user-20260707-artifacts-pages.png" alt="Artifacts center" width="100%" /> </p> Keep generated pages and reports in one place, with private-by-default sharing and a clean handoff for review. ### Monitoring <p align="center"> <img src="docs/assets/readme-tour/user-20260707-monitor.png" alt="Monitoring" width="100%" /> </p> Inspect fleet health, logs, traces, and alert state from the same workspace where the agent gathers evidence. ### Topology Map <p align="center"> <img src="docs/assets/readme-tour/user-20260707-topology-map.png" alt="Topology map" width="100%" /> </p> Visualize dependencies and blast radius so incidents can be traced through the affected service graph. ### Approval and Write Gate <p align="center"> <img src="docs/assets/readme-tour/user-20260707-rca-session.png" alt="Approval and write gate" width="100%" /> </p> Keep risky actions behind approvals, with a visible policy boundary before anything changes production systems. ## Documentation The full product documentation is available at [ongrid.cloud](https://ongrid.cloud/docs/get-started/introduction). | Area | Start here | |---|---| | **Get started** | [Introduction](https://ongrid.cloud/docs/get-started/introduction) · [Quickstart](https://ongrid.cloud/docs/get-started/quickstart) · [Architecture](https://ongrid.cloud/docs/get-started/architecture) · [Concepts](https://ongrid.cloud/docs/get-started/concepts) | | **Install & operate** | [Server install](https://ongrid.cloud/docs/install/server) · [Edge install](https://ongrid.cloud/docs/install/edge) · [First boot](https://ongrid.cloud/docs/install/first-boot) · [Upgrade](https://ongrid.cloud/docs/install/upgrade) | | **Capabilities** | [Alerts](https://ongrid.cloud/docs/capabilities/alerts) · [RCA](https://ongrid.cloud/docs/capabilities/rca) · [Monitoring](https://ongrid.cloud/docs/capabilities/monitoring) · [Logs](https://ongrid.cloud/docs/capabilities/logs) · [Traces](https://ongrid.cloud/docs/capabilities/traces) · [Knowledge](https://ongrid.cloud/docs/capabilities/knowledge) · [Skills](https://ongrid.cloud/docs/capabilities/skills) | | **Agents** | [Overview](https://ongrid.cloud/docs/agents/overview) · [Coordinator](https://ongrid.cloud/docs/agents/coordinator) · [Incident investigator](https://ongrid.cloud/docs/agents/incident-investigator) · [Specialists](https://ongrid.cloud/docs/agents/specialists) · [Reviewer](https://ongrid.cloud/docs/agents/reviewer) | | **Reference** | [API](https://ongrid.cloud/docs/reference/api) · [CLI](https://ongrid.cloud/docs/reference/cli) · [Alert rules](https://ongrid.cloud/docs/reference/alert-rules) · [Skill manifest](https://ongrid.cloud/docs/reference/skill-manifest) · [Data plane](https://ongrid.cloud/docs/reference/data-plane) | ## Integrations Drop-in for the observability, channel, and model stacks your team already uses. | | | |---|---| | **Observability** | <img src="https://api.iconify.design/logos:prometheus.svg" alt="Prometheus" title="Prometheus" width="28" height="28" />&nbsp;&nbsp;&nbsp;<img src="https://api.iconify.design/logos:grafana.svg" alt="Grafana" title="Grafana" width="28" height="28" />&nbsp;&nbsp;&nbsp;<img src="docs/assets/integrations/loki.svg" alt="Loki" title="Loki" width="28" height="28" />&nbsp;&nbsp;&nbsp;<img src="docs/assets/integrations/tempo.svg" alt="Tempo" title="Tempo" width="28" height="28" />&nbsp;&nbsp;&nbsp;<img src="docs/assets/integrations/opentelemetry.svg" alt="OpenTelemetry" title="OpenTelemetry" width="28" height="28" />&nbsp;&nbsp;&nbsp;<img src="https://api.iconify.design/logos:qdrant-icon.svg" alt="Qdrant" title="Qdrant" width="28" height="28" /> | | **Channels** | <img src="https://api.iconify.design/logos:slack-icon.svg" alt="Slack" title="Slack" width="28" height="28" />&nbsp;&nbsp;&nbsp;<img src="https://api.iconify.design/logos:telegram.svg" alt="Telegram" title="Telegram" width="28" height="28" />&nbsp;&nbsp;&nbsp;<img src="docs/assets/integrations/larksuite.svg" alt="Larksuite" title="Larksuite" width="28" height="28" />&nbsp;&nbsp;&nbsp;<img src="docs/assets/integrations/dingtalk.svg" alt="DingTalk" title="DingTalk" width="28" height="28" />&nbsp;&nbsp;&nbsp;<img src="https://cdn.simpleicons.org/wechat" alt="WeCom" title="WeCom" width="28" height="28" />&nbsp;&nbsp;&nbsp;<img src="https://api.iconify.design/logos:webhooks.svg" alt="Webhook" title="Webhook" width="28" height="28" /> | | **Models** | <img src="https://cdn.jsdelivr.net/npm/@lobehub/icons-static-svg@latest/icons/claude-color.svg" alt="Anthropic" title="Anthropic" width="28" height="28" />&nbsp;&nbsp;&nbsp;<img src="docs/assets/integrations/openai.svg" alt="OpenAI" title="OpenAI" width="28" height="28" />&nbsp;&nbsp;&nbsp;<img src="https://cdn.jsdelivr.net/npm/@lobehub/icons-static-svg@latest/icons/gemini-color.svg" alt="Gemini" title="Gemini" width="28" height="28" />&nbsp;&nbsp;&nbsp;<img src="https://cdn.jsdelivr.net/npm/@lobehub/icons-static-svg@latest/icons/deepseek-color.svg" alt="DeepSeek" title="DeepSeek" width="28" height="28" />&nbsp;&nbsp;&nbsp;<img src="docs/assets/integrations/zhipu.svg" alt="Zhipu" title="Zhipu" width="28" height="28" />&nbsp;&nbsp;&nbsp;<img src="https://cdn.jsdelivr.net/npm/@lobehub/icons-static-svg@latest/icons/kimi-color.svg" alt="Kimi" title="Kimi" width="28" height="28" /> | ## License AGPLv3 — see [LICENSE](LICENSE). Ongrid brand assets are not licensed under AGPLv3. See [TRADEMARK.md](TRADEMARK.md).