Command-line tool#
pip install awpy
awpy --help
Install the package to use awpy or python -m awpy:
Inspect CS2 demos with the Awpy CLI#
Each inspection command takes a demo path and accepts --json.
Dataset commands other than stats also accept --limit N.
Command |
Description |
|---|---|
|
Check that a file parses as a valid CS2 demo (magic bytes + header). |
|
Print the file header and playback info. |
|
List event names; pass a name to dump that event, |
|
Per-round table (start / freeze-end / end / official-end, winner, reason). |
|
Kills from |
|
Damage from |
|
Bomb actions (pickup / drop / plant / defuse) with site. |
|
Shots from |
|
Grenade / inferno / smoke summaries. |
|
Flash events: who was blinded, by whom, and for how long. |
|
Weapon-item transactions: purchases, pickups, and drops. |
|
Per-player scoreboard (kills, KAST, ADR, openings, trades). |
awpy info match.dem
awpy rounds match.dem
awpy events match.dem --summary
awpy events match.dem player_ping --json
awpy kills match.dem --limit 20
awpy stats match.dem
Dataset commands print Polars tables. With --json, they return row arrays.
Manage awpy-data with the Awpy CLI#
The same command manages the awpy-data
asset cache under ~/.awpy (see Visibility & map data):
awpy get # download the latest release
awpy get 2000873 # ... or a specific one (--force to re-download)
awpy versions # cached releases, and whether a newer one exists
awpy maps # maps available in a release
awpy clear 2000873 # delete one cached release (--all for everything)
Download a win probability model with the Awpy CLI#
awpy models get kumo-round-end/v1.0.0
The command downloads the model context, verifies its checksum, and keeps it in
the cache. To download the context again, add --force. For predictions and
plots, see Predict CS2 round outcomes with Awpy.
Inspect Source 2 internals with awpy-dev#
Use awpy-dev to inspect parser internals:
cargo install --path crates/awpy-dev # installs `awpy-dev`
awpy-dev messages match.dem --cmd Packet --limit 10
awpy-dev classes match.dem --filter Weapon
awpy-dev send-tables match.dem --filter CCSPlayerPawn
awpy-dev string-tables match.dem --table userinfo
awpy-dev entities match.dem --tick 100000 --class CCSPlayerPawn --fields
These inspection commands are not part of the Python API.