Quick Start

OpenSRE runs as a set of Docker Compose services. You can have a fully functional AI SRE platform running locally in under 5 minutes.

Prerequisites

  • Docker and Docker Compose installed
  • An LLM API key — OpenSRE uses OpenRouter by default, which gives access to Claude, GPT-4, and many other models. You only need OPENROUTER_API_KEY.
  • Git to clone the repository

Installation

1. Clone the repository

git clone https://github.com/swapnildahiphale/OpenSRE.git
cd OpenSRE

2. Configure environment

Create a .env file in the project root:

OPENROUTER_API_KEY=your-openrouter-api-key-here

That's the only required variable to get started. See Configuration for the full list of optional settings.

3. Start all services

make dev

This starts the following services:

| Service | Port | Description | |---------|------|-------------| | PostgreSQL | 5433 | Primary database | | config-service | 8081 | Configuration API | | Neo4j | 7475 (HTTP), 7688 (Bolt) | Knowledge graph | | LiteLLM | 4001 | LLM proxy | | sre-agent | 8001 | Investigation agent | | web-ui | 3002 | Admin console |

4. Open the web console

Navigate to http://localhost:3002 to access the OpenSRE admin console.

Trigger Your First Investigation

In the web console, you can trigger a test investigation:

  1. Click New Investigation in the sidebar
  2. Enter an alert description, for example: High error rate on payments-service: 5xx errors spiked to 15% in the last 10 minutes
  3. Click Investigate
  4. Watch as OpenSRE's agents gather context, investigate in parallel, and produce a report

The first investigation may take 2-5 minutes depending on which skills are invoked and your LLM's response time.

Add Slack Integration (Optional)

To receive alerts and investigations via Slack:

# Add to your .env
SLACK_BOT_TOKEN=xoxb-your-bot-token
SLACK_APP_TOKEN=xapp-your-app-token

# Start with Slack bot
make dev-slack

Next Steps