Download the SC2 Tools Agent

The agent is a small, single-file Windows program. It watches your Replays folder, parses each finished game in the background, and syncs the result here.

Windows (recommended)

Until the signed binary is published, you can run the agent from source. Both flows produce identical results.

Run from source

# 1. Clone the repo
git clone https://github.com/ReSpOnSeSC2/sc2tools.git
cd sc2tools/apps/agent

# 2. Install Python deps
py -m pip install -r requirements.txt

# 3. Configure
copy .env.example .env
# Edit .env and set SC2TOOLS_API_BASE to your API URL

# 4. Run
py -m sc2tools_agent

On first run the agent prints a 6-digit pairing code. Enter it on the Devices page to bind this machine to your account.

What does the agent do?

  • Watches your StarCraft II Replays folder.
  • Parses each new .SC2Replay with sc2reader (~150–500 ms per replay).
  • Runs the macro engine (with the chrono fix) to produce SQ, APM, and a per-build aggregate.
  • Uploads the resulting JSON record to your account. The replay file itself never leaves your machine.