WarMatrix is a high-fidelity, situational awareness platform that bridges the gap between tactical simulations and modern AI analytics. Designed for immersive command experience, it provides a unified "Glass Cockpit" for operational commanders across Land, Air, and Sea domains.
The WarMatrix interface is designed for high-density information display and tactical immersion.
| Main Landing Page | Scenario Builder |
|---|---|
 |
 |
| 2D Strategic Map | 3D Tactical Map |
|---|---|
 |
 |
| Command Console | Mission AI Briefing | Final Mission Report |
|---|---|---|
 |
 |
 |
The WarMatrix experience follows a structured operational workflow. From the initial terminal uplink to the final after-action review, the user acts as the central Node of Intelligence.
The user enters a Classified Command Console built with a dark-ops aesthetic—featuring scanline overlays and tactical grids. The "War Room" interface initializes with a secure system handshake, ensuring the user is placed into a focused, distraction-free strategic environment.
Using the AI Scenario Builder, the commander defines the battlefield parameters:
- Environmental Context: Selection of terrain (Highlands, Urban, Desert) and real-time weather effects (Storm, Fog, Sandstorm).
- ORBAT (Order of Battle): Strategic deployment of friendly units and identification of enemy threats via a 3D tactical grid.
- Strategist Briefing: The embedded AI Strategist synthesizes the deployment data, providing a high-level narrative briefing and initial tactical objectives.
Once the simulation is live, the user enters the active operational phase:
- Visual Intelligence: A 3D map (Three.js/Fiber) displays unit positions, movement vectors, and combat encounters.
- Natural Language Command: Orders are issued via the Secure Comms Console (e.g., "Move 1st Battalion to the bridge and hold for reinforce") instead of rigid menu clicks.
- Simulation Authority: The backend Python engine processes each command, calculating maneuver success, combat attrition, and objective control in real-time.
Upon mission completion, the system transitions to a Final Mission Report (After-Action Review):
- Casualty & Efficiency Analysis: Detailed metrics on personnel losses, armor damage, and ammunition expenditure.
- Strategic Scoring: The AI evaluates the commander's performance, providing a narrative critique of the tactics employed and suggesting improvements for future engagements.
- Framework: Next.js 15 (React 19)
- 3D Map Engine: Three.js via
React Three Fiber/@react-three/drei - Styling & Components: Tailwind CSS, Radix UI primitives, Lucide Icons
- Animations: Framer Motion for smooth, tactical UI transitions
- State Control: React hooks for low-latency synchronization with the simulation backend.
- API Layer: Python FastAPI (Uvicorn)
- Core Math: Custom Python-based simulation engine (
backend/engine/) handling pathfinding, combat probability, and state persistence.
- Engine: Local LLM Backend (
ai_server/). - Model Layer: Fine-tuned local models (e.g. Qwen, Llama).
- Functionality:
- Dynamic scenario generation based on user parameters.
- Narrative transformations of raw simulation data into military-grade briefings.
- Strategic prediction of enemy behavior.
src/: Next.js App Router, custom components (Map, HUD, Console), and client-side simulation logic.backend/: FastAPI implementation and the core simulation math for the battlefield engine.ai_server/: Local LLM backend server and model checkpoint management.docs/: Technical blueprints and design specifications.scripts/: Development utilities for service orchestration.
- Node.js (v20+)
- Python (v3.10+)
- NVIDIA GPU (Required for local LLM inference)
- Dependencies:
npm install - Simulation Backend: Ensure you have a
.venvin the/backenddirectory and runpip install -r requirements.txt. - AI Server: See
ai_server/requirements.txtfor local LLM setup. - Run Services:
# Launches both Frontend and Backend concurrently npm run dev
WarMatrix is released under the MIT License. See LICENSE for more details.