GankMeDaddy — Dota 2 Live Coaching Agent

A lightweight Windows 11 system tray application that provides real-time voice coaching for all five positions, using pro player match data and STRATZ pro guides as benchmarks.

Features

• Real-time voice coaching via offline high-quality neural Piper TTS with standard OneCore Speech fallback. Volume adjustable (0-100) from the tray.
• Data-driven benchmarks from pro player STRATZ match history and STRATZ pro guides (item timings, GPM, KDA).
• Dota 2 Game State Integration for live game telemetry (HP, mana, gold, items, abilities), locked down locally to 127.0.0.1.
• 32 heroes across all 5 positions with dedicated, robust strategy modules.
• Dynamic Build-Path Branching — Automatically detects physical/magical item trajectories and filters advice dynamically.
• Enemy Counter Briefings — Pre-game analysis and counter tips for dangerous opponent heroes.
• Rune/Lotus/Shrine timers with voice reminders.
• Creep score checkpoints at 10/20/30 min vs pro player pace.
• Priority-based TTS queue with interrupt protection and cooldown deduplication.
• Lightweight System Tray — Position selector (mid/pos1/pos3/pos4/pos5), voice toggle, volume +/- controls, setup GSI, or close the application.

Supported Heroes

Mid (9)

Pos 5 — Hard Support (4)

Pos 4 — Soft Support (5)

Pos 3 — Offlane (7)

Pos 1 — Safelane Carry (7)

Quick Start

1. Install dependencies

npm install

2. Configure .env

The .env file should contain your STRATZ API token and Steam ID:

STRATZ_API_TOKEN=your_token_here
STEAM_ACCOUNT_ID=your_steam_id

3. Dota 2 Setup

Add -gamestateintegration to Dota 2's Steam launch options:

1. Open Steam → Right-click Dota 2 → Properties
2. In Launch Options, add: -gamestateintegration

The app will auto-copy the GSI config file to your Dota 2 directory on first run.

4. Run

npm start

The app will:

1. Initialize GSI Server on port 3001 (listening on localhost 127.0.0.1 only).
2. Load configuration and pre-fetch pro match data/STRATZ guides for enabled heroes in the background.
3. Show the system tray icon with status alerts.

How It Works

Dota 2 Client (GSI) ───► GSIServer (Port 3001, localhost)
                                 │
                           MatchTracker
                                 │
                         CoachingEngine ◄─── STRATZ API (Pro / Guide data)
                                 │
                           VoiceOutput (TTS)

1. Dota 2 GSI sends real-time game state to 127.0.0.1:3001 every 0.5s.
2. Match Tracker converts GSI data into normalized snapshots.
3. STRATZ Pro Analyzer provides real item timing benchmarks from pro matches or fallback pro guides.
4. Coaching Engine evaluates general, build-path, counter, and hero-specific rules.
5. Voice Output plays speech via Windows SAPI or neural Piper TTS with queue deduplication.

Architecture & Code Map

For a detailed breakdown of the components, read our Codemaps Index.

src/
├── index.ts                   # Entry point and event coordinator
├── config/configManager.ts    # Settings persistence (%APPDATA%)
├── stratz/
│   ├── stratzClient.ts        # STRATZ GraphQL client with timeouts/retries
│   ├── proAnalyzer.ts         # Pro match & guide analyzer
│   └── queries.ts             # GraphQL queries
├── gsi/
│   ├── gsiServer.ts           # GSI HTTP server (localhost-only)
│   └── gsiTypes.ts            # TypeScript types for GSI
├── coaching/
│   ├── coachingEngine.ts      # Main coaching engine (role-aware)
│   ├── matchTracker.ts        # Match/draft orchestrator
│   ├── heroesData.ts          # Static hero index metadata
│   └── types.ts               # Shared types (Role, HERO_IDS, HERO_ROLES)
├── strategies/                # Hero-specific strategy modules (32)
│   ├── index.ts               # Registry — maps hero ID → strategy
│   ├── voidSpiritStrategy.ts, sniperStrategy.ts, ...
│   └── (+30 more for pos1/3/4/5)
├── voice/voiceOutput.ts       # Offline Piper & OneCore TTS manager (volume-aware)
└── tray/trayApp.ts            # System tray UI controller (position + volume)

License

Licensed under the GNU General Public License v3.0.