Skip to content
AI Red vs Blue Arena

Quick Start

Quick Start

Get the AI Red vs Blue Arena running in 3 commands.

Prerequisites

  • Node.js 18+ and pnpm (or npm)
  • Docker Desktop (for Kestra - optional)
  • No API keys required! System works with mock providers
  • Optional: Groq/OpenAI/Anthropic API keys for real LLM responses

Fastest Start (3 Commands)

Terminal window
# 1. Check dependencies
.\scripts\check-dependencies.ps1


# 2. Start everything
.\scripts\start-all.ps1


# 3. Test everything
.\scripts\test-e2e.ps1

Then open: http://localhost:3000

Manual Setup

Backend Setup

Terminal window
cd backend
pnpm install
cp .env.example .env
# Edit .env with your API keys (optional - will use mock if not provided)
pnpm run dev

The backend will run on:

Frontend Setup

Terminal window
cd frontend
pnpm install
pnpm run dev

The frontend will run on http://localhost:3000

Seed Default Agents

Terminal window
cd backend
tsx src/scripts/seed.ts

This creates default Red, Blue, and Target agents with Groq models.

Kestra Setup (Optional)

Terminal window
cd kestra
docker-compose up -d

Kestra UI will be available at: http://localhost:8080

Import flows from kestra/flows/ai-arena/all-flows-combined.yml via the Kestra UI.

What’s Next?