Quick Start

This guide walks you through setting up JuryArena locally and verifying it works.

Prerequisites

• Docker and Docker Compose available
• Node.js v24.x or later installed

1. Clone the Repository

git clone https://github.com/elementshq/jury-arena.git
cd jury-arena

2. Configure Environment Variables

Create the environment file for the web application:

cp web/.env.example web/.env

Edit web/.env as needed to set LLM API keys and other settings. For details on API key configuration, see LLM Configuration › API Keys.

3. Configure LLMs

Set up the LLMs you want to use for evaluation:

cp web/config/models.example.yaml web/config/models.yaml

Edit web/config/models.yaml as needed. For details, see LLM Configuration.

4. Start the Application

Use Docker Compose to start the application:

cd infra
docker compose up -d

Open http://localhost:3000 in your browser and confirm the dashboard loads.

Next Steps

• See Overview for the overall project structure.