🚀 Launch App | 📖 Documentation | 🐞 Report Bug
Simulate thousands of Magic: The Gathering Commander games to predict tournament brackets. Powered by Forge and Docker.
Run the full stack locally. See Deployment Guide for detailed setup.
-
Install dependencies:
npm run install:all
-
Start the App (Frontend & API):
npm run dev
-
Start the Worker (in a new terminal): Note: Requires Docker to be running.
cd worker && npm run dev
Visit http://localhost:5173 to start simulating.
- ⚡ Parallel Simulation: Runs multiple Forge instances concurrently via Docker.
- 📊 Win Rate Analysis: Tracks per-deck win rates and game statistics across simulations.
- ☁️ Hybrid Architecture: Runs fully locally or on Google Cloud Platform.
- Architecture Overview: Deep dive into the system design, Docker worker, and data flow.
- Deployment Guide: Detailed setup instructions, prerequisites, and cloud deployment.
- Mode Setup: Configure for Local vs GCP operation.
- Secrets Setup: How to configure API keys and credentials.
- Remote Worker Setup: Deploy the worker on a separate machine with auto-updates via Watchtower.
We welcome contributions! Please see our Contributing Guide to get started.