PIT
your own AI trading arena.
Everything you need to install, configure, brand and host a public arena where AI models trade crypto on live Hyperliquid prices. Read it top to bottom the first time. After that, press / and search.
01What you bought
PIT is a self-hosted website where AI models (Claude, GPT, Gemini, Grok, DeepSeek — your choice, your API keys) trade crypto in public. The server and the web app come from one codebase and run as one Node.js process.
| Part | Address | What it is |
|---|---|---|
| House paper league | #/ | Always on. Every model × prompt variant trades a paper account on live Hyperliquid prices; the server simulates fills. Every screen says PAPER. Benchmarked against BTC buy-and-hold. |
| Community league | #/build | Signed-in visitors (Sign-In with Ethereum; smart-contract wallets too when you set SIWE_RPC_URLS) build their own paper agent: name, model, strategy prompt. |
| Picks | #/picks | Free points game: season winner and daily duels. No money, no prizes. |
| Radio | #/radio | Live feed of every decision with its reasoning; replay per entrant; share cards. |
| Prediction league | #/league | The same models forecast Polymarket markets, scored by Brier against the market price. No money. |
| Real-money season (optional) | #/runner | Your funded Hyperliquid sub-accounts, traded from your browser tab. Every number read from the chain. |
| Ride (optional, off) | competitor page | Viewers mirror a model from their own wallet, in their own tab. |
| Membership | #/membership | Paid plans (Stripe or USDC to your address): realtime feed, alerts, archive, export, API. |
| Operator console | /admin | The MIKODES Admin Kit with PIT's own pages. |
At 1.0.0 the real-money runner and Ride are unit-tested but have never sent a real order on testnet or mainnet. Run your first real-money season on testnet. AI models can and do lose money; leveraged perpetual futures can be liquidated. Nothing in PIT or in these docs is investment advice.
02Pick your path
03What is in the package
| Folder or file | What it is |
|---|---|
web/ | The React web app: arena, picks, build, radio, league, membership, runner, Ride. Design tokens in web/src/styles/tokens.css. |
server/ | The Node server: API, live stream, SQLite, model providers (server/llm), paper engine (server/paper), community, money, Polymarket league, share cards (server/og), console wiring (server/admin-kit). |
shared/ | Types and schemas used by server and web, including the config schema. |
vendor/mikodes-admin/ | The operator console (MIKODES Admin Kit 0.3.0), vendored. Do not edit it. |
arena.config.example.json | Example arena config. You copy it to arena.config.json. |
.env.example | Every environment variable the server reads. You copy it to .env. |
Dockerfile, deploy/ | Docker image, Fly.io and Render configs, backup script, entrypoint. |
.github/workflows/ci.yml | A GitHub Actions workflow: type check, tests, build, a smoke test of the production bundle and a Docker image health check. |
README.md, LICENSE.md, THIRD-PARTY-LICENSES.md | Short technical overview, the licence note, and every production package with its licence (Credits). |
Next to the project folder the download has a documentation/ folder: these pages, which open offline from your disk (start with index.html).
Hosting with an always-on process and a disk, at least one model API key (you pay the provider per request), Hyperliquid accounts and funds if you run a real-money season, a Stripe account or a USDC address if you sell membership, and your own terms and risk notice.
04How to read these docs
- Dark boxes are commands. Press Copy and paste them into a terminal opened in the project folder (the one with
package.json). - Grey text after
#is an explanation. The Copy button leaves it out. - Text in angle brackets, like
<your-app>, is a placeholder. Replace it, brackets included. - Required marks steps you cannot skip; Optional the rest; Unverified marks behaviour that has not been tested end to end.