Quickstart

Three steps to a live stack

01

Clone and configure

The stack runs without a key (collection, queries, alerting); the agent needs one.

git clone https://github.com/Joshwong1908/relionaut.git && cd relionaut
cat >> .env <<'EOF'
GLM_API_KEY=your-key            # any Anthropic-compatible endpoint
GLM_BASE_URL=https://open.bigmodel.cn/api/anthropic
GLM_MODEL=glm-4.6
EOF
02

Start the stack

docker compose up -d --build

Open http://localhost:8082. Within 30 seconds the dashboard shows live telemetry; the alert engine evaluates rules every 60s, opens incidents, and — with a key configured — runs an automatic investigation on each new incident.

03

Talk to the agent

Open any incident and chat: the agent investigates with read-only tools (query_logs, query_metrics, whitelisted host commands, HTTP probes) and streams its reasoning. Conclusions arrive through submit_findings with verbatim evidence quotes. After a run, distill it into a lesson with POST /api/incidents/:id/distill.

What runs where

ServicePortRole
nginx8082static console + /api proxy
apiinternalHono routes, alert engine, investigation agent
postgresinternalincidents, trajectories, telemetry
redisinternalrate limiting