Constitutional AIOpsAutonomous infrastructure management with a safety layer
A dual-agent system that annotates telemetry, finds root cause, and proposes remediation. Every action passes a constitutional safety gate and, when uncertain, waits for human approval. Bring your own OpenAI-compatible LLM endpoint.
Point both agents at any OpenAI-compatible endpoint (vLLM, Ollama, AWS Bedrock, OpenAI). One endpoint and model is enough for a minimal setup, or run two for the dual-engine reference configuration.
Constitutional safety
Twelve principles across three tiers gate every proposed action. High-confidence actions are audited, uncertain ones require human approval, and low-confidence ones only alert.
One-command lite self-host
The lite profile runs the backend and frontend on roughly 0.74 GiB of RAM, with no GPU and no bundled models. It degrades gracefully without Neo4j or the observability stack.
Graph-episodic memory
Optional Neo4j memory correlates incidents and retains context across time. Without it the lite tier uses a persistent embedded SQLite episode store with similarity search, so episodes survive a restart.
Constitutional AIOps ingests logs, metrics, and traces, uses a fast agent to annotate and classify them, and a reasoning agent to correlate incidents, explain root cause, and draft remediation. Nothing is executed blindly. A constitutional validator scores each proposed action, and the authorization matrix decides whether it runs automatically, waits for a human, or only raises an alert.
The recommended way to run it is the lite profile: the backend and frontend plus your own OpenAI-compatible LLM endpoint. No GPU, no bundled models, no Neo4j required.
bash
git clone https://github.com/Partha-dev01/Constitutional-AIOps.git constitutional-aiopscd constitutional-aiopscp .env.example .env # set your LLM endpoint (both agents may share one)docker compose -f docker/docker-compose.lite.yml --env-file .env up -d# Frontend http://localhost:3000# Backend http://localhost:8000/docs
Continue with the Overview, or jump to Self-Hosting for every deployment option.
Constitutional AIOps is released under the GNU Affero General Public License v3.0. If you run a modified version as a network service, you must offer its users the corresponding source of your modified version.
