How ankit25bcs10610/omnipotent works
OmniPotent is an AI SRE copilot: an engineer or incoming alert starts an investigation, agents gather and rank operational evidence, and the system produces a root-cause report. Remediation is a separate confidence-, policy-, and simulation-gated workflow that requests human approval when a gate fails. The README also documents incident deduplication, integrations, service topology, SLOs, runbooks, on-call, and enterprise controls. Relationships among unsampled subsystems are included only where the README describes them; source excerpts provide additional evidence for tenant context and persistence.
Main entry points: main.py API Surface · agents Investigation Agents · engine.py Policy Engine · router.py Alert Webhooks
Components 25
User and API
- API Surface
app/api/main.py - Alert Webhooks
app/webhooks/router.py
Investigation
- Investigation Coordinator
app/coordinator/dag_executor.py - Investigation Agents
app/agents - MCP Tool Servers
app/mcp/servers - Direct Connectors
app/connectors - Evidence Store
app/evidence/store.py - Root-Cause Report
app/contracts/root_cause.py
Safety and Action
- Confidence Verification
app/verification/verification_agent.py - Policy Engine
app/policy_engine/engine.py - Digital-Twin Simulation
app/digital_twin/simulator.py - Human Approval
app/api/v1/decision.py - Remediation
app/agents/remediation.py
Operations
- Alert Deduplication
app/deduplication/pipeline.py - Dependency Topology
app/dependency_graph - SLO Tracking
app/slo/tracker.py - Runbook Execution
app/runbooks/executor.py - On-call Escalation
app/oncall/escalation_service.py - Notification Delivery
app/notifications/delivery.py
Platform Services
- Tenant Context
app/tenant_context.py - Application Database
app/database/engine.py - Audit Log
app/audit/immutable_log.py - Billing
app/billing
Other components
- On-call Engineer
- Alert Source
Connections 26
- On-call Engineer → API Surface: starts investigation
- Alert Source → Alert Webhooks: sends alert
- Alert Webhooks → Alert Deduplication: submits alerts
- Alert Deduplication → Investigation Coordinator: starts investigation
- API Surface → Investigation Coordinator: drives investigation
- Investigation Coordinator → Investigation Agents: coordinates agents
- Investigation Agents → MCP Tool Servers: queries tools
- Investigation Agents → Direct Connectors: queries systems
- Investigation Agents → Evidence Store: records evidence
- Investigation Agents → Root-Cause Report: writes report
- Root-Cause Report → Confidence Verification: measures confidence
- Confidence Verification → Policy Engine: gates action
- Policy Engine → Digital-Twin Simulation: allows simulation
- Digital-Twin Simulation → Remediation: verifies rollback
- Policy Engine → Human Approval: requests approval
- Human Approval → Remediation: authorizes action
- Dependency Topology → Policy Engine: informs blast radius
- API Surface → SLO Tracking: serves SLO features
- API Surface → Runbook Execution: serves runbooks
- API Surface → On-call Escalation: serves on-call
app/api/main.py - On-call Escalation → Notification Delivery: delivers escalations
app/oncall/escalation_service.py - Alert Webhooks → Tenant Context: resolves tenant
app/webhooks/router.py - API Surface → Tenant Context: sets request tenant
app/api/main.py - Tenant Context → Application Database: scopes persistence
- API Surface → Audit Log: records audit
- API Surface → Billing: exposes billing