JevArena

September 18, 2026 ยท View on GitHub

A spectator arena where two independent Jev Agents play Snake against each other.

JevArena is a public Next.js app: Landing at /, then the Arena. Each Spectator's page runs its own Match. Jev is reached only through Vercel AI Gateway.

Run locally

npm install
cp .env.example .env.local
npm run dev

Open http://127.0.0.1:43123. The Landing explains the Match; Enter the Arena opens /arena with two isolated Snake Browsers.

AI_GATEWAY_API_KEY is the only credential. Copy .env.example to .env.local and leave the value empty to watch a labeled Demo policy Match. Set the key to drive both Agents with Jev through Vercel AI Gateway. Never commit .env.local. The key stays on the server.

If Jev fails, that Agent is BLOCKED. The Demo policy does not run in that case.

Scripts

CommandWhat it does
npm run devDev server on port 43123
npm run typecheckTypeScript (tsc --noEmit)
npm run lintESLint
npm testUnit tests (Vitest)
npm run buildProduction build
npm startServe the production build on port 43123

License

MIT