DeepBattler is an LLM-powered coaching tool for Hearthstone Battlegrounds, designed to provide real-time strategic advice and voice-assisted guidance. It targets Hearthstone players aiming to improve their gameplay and climb ranks, offering insights comparable to top-tier players.

How It Works

DeepBattler integrates with the Hearthstone Deck Tracker (HDT) via a custom plugin. The plugin monitors game state, outputs data as JSON, and feeds this into a Python agent. This agent leverages LLMs (OpenAI GPT or Google Gemma) to analyze the game state and provide strategic recommendations, including voice interaction.

Quick Start & Requirements

• Plugin Setup: Requires Visual Studio, adding HearthDb.dll and HearthstoneDeckTracker.exe as project references, setting "Copy Local" to True, and placing the compiled DeepBattlerPlugin.dll into the HDT plugins directory. Configure the game_state.json path in DeepBattlerPlugin.csproj.
• LLM Agent Setup:
  • OpenAI: pip install openai playsound==1.2.2, configure API key in Openai_caller.py, run python Openai_caller.py.
  • Gemma: pip install keras_hub jax keras gtts playsound==1.2.2, set environment variables (KERAS_BACKEND, XLA_PYTHON_CLIENT_MEM_FRACTION), prepare game_state.json and Prompt.txt, run python Gemma_caller.py.
• Dependencies: Hearthstone Deck Tracker (HDT), Visual Studio (for plugin development), Python 3.x, OpenAI API key or Gemma setup.

Highlighted Details

• Claims performance matching top 0.1% EU players (8K ELO).
• Offers voice-assisted guidance for real-time decision-making.
• Supports both OpenAI GPT and Google Gemma as LLM backends.
• Integrates seamlessly with Hearthstone Deck Tracker (HDT).

Maintenance & Community

• Project maintained by William-Dic.
• No specific community links (Discord, Slack) or roadmap are provided in the README.

Licensing & Compatibility

• License: Custom Non-Commercial License. Allows personal, educational, or non-commercial use, modification, and sharing. Commercial use or distribution requires permission.
• Compatibility: Uses Hearthstone assets; users must comply with Blizzard's terms. Includes components from Hearthstone Deck Tracker (HDT) by HearthSim.

Limitations & Caveats

The plugin setup requires familiarity with Visual Studio project referencing and file placement. The license explicitly prohibits commercial use. Compatibility is dependent on matching HDT and DLL versions.