{"id":49543945,"url":"https://github.com/ytfl/warmatrix","last_synced_at":"2026-05-02T17:05:13.083Z","repository":{"id":351791212,"uuid":"1174182552","full_name":"YTFL/WarMatrix","owner":"YTFL","description":"WarMatrix is a tactical simulation and command console application featuring a 3D tactical map interface, a scalable backend simulation engine, and an AI integration layer for an immersive operational dashboard.","archived":false,"fork":false,"pushed_at":"2026-04-26T14:52:52.000Z","size":3984,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-26T16:26:27.428Z","etag":null,"topics":["ai-simulation","command-and-control","defence-technology","fastapi","glassmorphism","local-llm","military-simulation","mission-control","next-js","operational-technology","pytorch","qwen","react-three-fiber","situational-awareness","tactical-simulation","tactical-visualization","threejs","typescript","unsloth","wargaming"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/YTFL.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-06T06:44:10.000Z","updated_at":"2026-04-26T14:52:57.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/YTFL/WarMatrix","commit_stats":null,"previous_names":["ytfl/warmatrix"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/YTFL/WarMatrix","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YTFL%2FWarMatrix","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YTFL%2FWarMatrix/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YTFL%2FWarMatrix/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YTFL%2FWarMatrix/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/YTFL","download_url":"https://codeload.github.com/YTFL/WarMatrix/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YTFL%2FWarMatrix/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32542203,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-02T12:25:33.646Z","status":"ssl_error","status_checked_at":"2026-05-02T12:24:51.733Z","response_time":132,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-simulation","command-and-control","defence-technology","fastapi","glassmorphism","local-llm","military-simulation","mission-control","next-js","operational-technology","pytorch","qwen","react-three-fiber","situational-awareness","tactical-simulation","tactical-visualization","threejs","typescript","unsloth","wargaming"],"created_at":"2026-05-02T17:05:01.355Z","updated_at":"2026-05-02T17:05:13.072Z","avatar_url":"https://github.com/YTFL.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# WarMatrix: AI-Enabled Tactical Simulation Console\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n![Next.js 15](https://img.shields.io/badge/Next.js-15-black?logo=next.js)\n![FastAPI](https://img.shields.io/badge/FastAPI-0.109+-009688?logo=fastapi)\n![React 19](https://img.shields.io/badge/React-19-61DAFB?logo=react)\n![Tailwind CSS](https://img.shields.io/badge/Tailwind_CSS-3.4-38B2AC?logo=tailwind-css)\n![Three.js](https://img.shields.io/badge/Three.js-r178-black?logo=three.js)\n![TypeScript](https://img.shields.io/badge/TypeScript-5.x-3178C6?logo=typescript)\n![Python](https://img.shields.io/badge/Python-3.12-3776AB?logo=python)\n![PyTorch](https://img.shields.io/badge/PyTorch-2.5-EE4C2C?logo=pytorch)\n![NVIDIA CUDA](https://img.shields.io/badge/CUDA-12.1-76B900?logo=nvidia)\n\nWarMatrix 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.\n\n---\n\n## 🖼️ Mission Visuals\n\nThe WarMatrix interface is designed for high-density information display and tactical immersion.\n\n| **Main Landing Page** | **Scenario Builder** |\n| :---: | :---: |\n| ![Landing Page](./screenshots/landing.png) | ![Scenario Builder](./screenshots/builder.png) |\n\n---\n\n| **2D Strategic Map** | **3D Tactical Map** |\n| :---: | :---: |\n| ![2D Strategic Map](./screenshots/2d_map.png) | ![3D Tactical Map](./screenshots/3d_map.png) |\n\n---\n\n| **Command Console** | **Mission AI Briefing** | **Final Mission Report** |\n| :---: | :---: | :---: |\n| ![Command Console](./screenshots/console.png) | ![AI Briefing](./screenshots/briefing.png) | ![Final Report](./screenshots/report.png) |\n\n---\n\n## 🎖️ Operational User Perspective: A 4-Step Narrative\n\nThe 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.\n\n### Step 1: Secure Terminal Uplink \u0026 Domain Entry\nThe 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.\n\n### Step 2: Intelligent Scenario Synthesis\nUsing the **AI Scenario Builder**, the commander defines the battlefield parameters:\n- **Environmental Context:** Selection of terrain (Highlands, Urban, Desert) and real-time weather effects (Storm, Fog, Sandstorm).\n- **ORBAT (Order of Battle):** Strategic deployment of friendly units and identification of enemy threats via a 3D tactical grid.\n- **Strategist Briefing:** The embedded **AI Strategist** synthesizes the deployment data, providing a high-level narrative briefing and initial tactical objectives.\n\n### Step 3: Real-Time Tactical Command Loop\nOnce the simulation is live, the user enters the active operational phase:\n- **Visual Intelligence:** A 3D map (Three.js/Fiber) displays unit positions, movement vectors, and combat encounters.\n- **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.\n- **Simulation Authority:** The backend Python engine processes each command, calculating maneuver success, combat attrition, and objective control in real-time.\n\n### Step 4: Post-Operation Debrief (AAR)\nUpon mission completion, the system transitions to a **Final Mission Report** (After-Action Review):\n- **Casualty \u0026 Efficiency Analysis:** Detailed metrics on personnel losses, armor damage, and ammunition expenditure.\n- **Strategic Scoring:** The AI evaluates the commander's performance, providing a narrative critique of the tactics employed and suggesting improvements for future engagements.\n\n---\n\n## 🛠️ Technical Architecture\n\n### 🖥️ Frontend (Command UI)\n*   **Framework:** Next.js 15 (React 19)\n*   **3D Map Engine:** Three.js via `React Three Fiber` / `@react-three/drei`\n*   **Styling \u0026 Components:** Tailwind CSS, Radix UI primitives, Lucide Icons\n*   **Animations:** Framer Motion for smooth, tactical UI transitions\n*   **State Control:** React hooks for low-latency synchronization with the simulation backend.\n\n### ⚙️ Backend (Sim Engine)\n*   **API Layer:** Python FastAPI (Uvicorn)\n*   **Core Math:** Custom Python-based simulation engine (`backend/engine/`) handling pathfinding, combat probability, and state persistence.\n\n### AI Integration: Synthetic Strategy\n- **Engine:** Local LLM Backend (`ai_server/`).\n- **Model Layer:** Fine-tuned local models (e.g. Qwen, Llama).\n- **Functionality:** \n  - Dynamic scenario generation based on user parameters.\n  - Narrative transformations of raw simulation data into military-grade briefings.\n  - Strategic prediction of enemy behavior.\n\n---\n\n## 📂 Project Structure\n\n- **`src/`**: Next.js App Router, custom components (Map, HUD, Console), and client-side simulation logic.\n- **`backend/`**: FastAPI implementation and the core simulation math for the battlefield engine.\n- **`ai_server/`**: Local LLM backend server and model checkpoint management.\n- **`docs/`**: Technical blueprints and design specifications.\n- **`scripts/`**: Development utilities for service orchestration.\n\n---\n\n## 🚀 Getting Started\n\nTo initialize the WarMatrix environment, configure the simulation engine, and deploy the AI Strategist, please refer to our central onboarding documentation:\n\n👉 **[Universal Setup Guide](./setup.md)**\n\n### ⚡ Quick Start\n```bash\n# Install dependencies\nnpm install\n\n# Start the full tactical suite\nnpm run dev\n```\n\n---\n\n## 📜 License\n\nWarMatrix is released under the **MIT License**. See [LICENSE](LICENSE) for more details.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fytfl%2Fwarmatrix","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fytfl%2Fwarmatrix","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fytfl%2Fwarmatrix/lists"}