ChatWar

A fight club for LLMs. 🤫

▶ https://chatwar.ai/demo

Overview

ChatWar is an AI battleground for comparing large language models. It’s built as a monorepo with a web client, an API, and shared packages.

The default development experience is mock-first, with an opt-in full local stack.

Prerequisites

• Node.js 18+
• pnpm
• Docker Desktop (only required for dev:full)

Local Development

Install dependencies:

pnpm install

Default (mock mode)

Runs the web app using MSW mocks. No API or database required.

pnpm dev

Web: http://localhost:5173

Full local stack (API + Postgres)

docker ps # verify docker desktop is running
pnpm dev:full

Services:

• Web: http://localhost:5173
• API: http://localhost:3001

Run services individually

pnpm dev:web:mock
pnpm dev:web:localserver
pnpm dev:api

Database

docker ps # verify docker desktop is running
pnpm db:up
pnpm db:down
pnpm db:reset

Environment Variables

API:

cp apps/api/.env.example apps/api/.env

Web:

cp apps/web/.env.example apps/web/.env.local

Prisma

pnpm --filter @chatwar/api exec prisma migrate dev
pnpm --filter @chatwar/api exec prisma generate

API Contracts

• Swagger UI (local): http://localhost:3001/api-docs
• Swagger UI (prod): https://api.chatwar.ai/api-docs

Production

pnpm install
pnpm build
pnpm preview

If you find this useful or learned something new, consider starring the repo ⭐