Prerequisites

What you need before running ApexLab locally.

---

For the Desktop App (WPF client)

Requirement	Version	Notes
Windows	10 or 11	WPF is Windows-only
.NET SDK	8.0+	Download
Visual Studio / Rider	Any recent	VS 2022 17.8+ or JetBrains Rider 2024+

---

For the Backend API

Requirement	Version	Notes
.NET SDK	8.0+	Same SDK as above
Docker Desktop	Any	For Postgres + Redis local containers
Python	3.x	Only needed for mkdocs serve (docs)

---

For Contributions

Requirement	Notes
Git	Any recent version
GitHub account	For PRs
Access to the repo	Private — request from the team

---

Optional

Tool	Purpose
Le Mans Ultimate (Steam)	Live capture testing
rF2 Shared Memory Map Plugin	Required for LMU/rF2 live capture
Postman / Bruno	API testing

---

Accounts & Secrets

To run the full stack locally you will need:

• Google or Discord OAuth credentials — create a Google Cloud or Discord Developer app and set the redirect URI to http://localhost:5000/v1/auth/callback/{provider}
• Anthropic API key — from console.anthropic.com (required for AI coach)
• Railway access — contact the team for production deploy access

For local development, the API will start without OAuth or Anthropic keys — those features will return errors but the rest of the stack works.