VOID

AI Incident Intelligence for Autonomous Agents — Infrastructure

This repository orchestrates the complete VOID platform using Docker Compose.

---

Architecture

┌─────────────────────────────────────────────────────────┐
│                    VOID Platform                        │
├─────────────┬─────────────┬─────────────┬──────────────┤
│ void-server │   worker    │  sampling   │   demo/docs  │
│    (API)    │ (incident)  │ (adaptive)  │              │
└──────┬──────┴──────┬──────┴──────┬──────┴──────┬───────┘
       │             │             │             │
       ▼             ▼             ▼             ▼
┌──────────────┐ ┌────────┐ ┌─────────────┐ ┌─────────┐
│  PostgreSQL  │ │ Redis  │ │   SigNoz    │ │  Nginx  │
│     16       │ │   7    │ │  ClickHouse │ │         │
└──────────────┘ └────────┘ └─────────────┘ └─────────┘

---

Requirements

• Docker Engine 24+
• Docker Compose v2+
• 4GB+ RAM (SigNoz requires significant memory)

---

Quick Start

git clone https://github.com/void-hq/void.git

cd void

cp .env.sample .env

# Required: set your Google Gemini API key before starting
# Edit .env and fill in GOOGLE_API_KEY
docker compose up

Containers start automatically once configured. Ensure GOOGLE_API_KEY and any other required values are set in .env before the first startup.

---

Services

Service	Description	Port
void-server-api	REST API for incidents, traces, health	3001
void-server-worker	Incident evaluation & issue generation	—
void-server-sampling	Adaptive sampling consumer	—
void-demo	Interactive demo application	3000
void-docs	Documentation site	80
postgres	Primary database	5432
redis	Queue backend (BullMQ)	6379
signoz	Observability dashboard	8080
signoz-otel-collector	OTLP receiver (gRPC/HTTP)	4317, 4318
signoz-clickhouse	Telemetry storage	9000, 8123

---

URLs

After starting the platform:

URL	Description
http://localhost:3001/health	API health check
http://localhost:3001/api/incidents	List incidents
http://localhost:3000	Demo application
http://localhost:80	Documentation
http://localhost:8080	SigNoz dashboard
http://localhost:4317	OTLP gRPC endpoint
http://localhost:4318	OTLP HTTP endpoint

---

Persistent Storage

All data survives container restarts via named Docker volumes:

Volume	Purpose
postgres-data	PostgreSQL database
redis-data	Redis persistence
signoz-metastore-data	SigNoz metadata
signoz-clickhouse-data	ClickHouse telemetry
signoz-clickhouse-keeper-data	ClickHouse keeper
signoz-clickhouse-user-scripts	ClickHouse user scripts
void-storage	Generated reports, cache, artifacts

---

Updating Images

Pull the latest images and restart:

docker compose pull

docker compose up -d

---

Configuration

All configuration is in .env. See .env.sample for available options.

Required:

GOOGLE_API_KEY=your-api-key    # For AI evaluation (evaluator + issue-agent)

---

Development

For development with local code changes, see the individual repositories:

• void-server
• void-demo
• void-docs

---

License

MIT