I Built an Offline Match Analyst That Turns Event Data Into Evidence-Cited Tactics

Description and use

MatchLens is an offline tool that turns football match event CSVs into an evidence‑cited tactical report, revealing insights such as xG comparison, key moments, and momentum phases.

Problem

Football pundits often provide narrative explanations for match outcomes that lack data-backed evidence, leading to unsubstantiated claims.

Outcome

MatchLens transforms raw event CSVs into a concise, evidence‑cited tactical report, revealing insights such as the impact of a red card on xG and momentum, and correcting narrative misconceptions.

Workflow

• Export match events and team info to CSV
• Run python -m matchlens analyze <events.csv> <teams.csv> <match description>
• Review the generated report and evidence citations
• Use insights to argue or inform coaching decisions

Evidence

MatchLens produces: xG comparison – who actually created what, not who scored

Source

Every insight carries evidence citations: the event rows and numbers it used. No vibes, no narrative hand‑waving.

Source

The red‑card finding is the one I care about: the tool splits the match at the dismissal and compares both halves on xG.

Source