git404hub

what is event-data-chatbot fr?

parmacalcio1913/event-data-chatbot — explained in plain English

Analysis updated 2026-05-18

26PythonAudience · developerComplexity · 3/5LicenseSetup · moderate

tl;dr

A command-line chatbot that answers plain-English questions about football match data using Claude and a local StatsBomb dataset.

vibe map

mindmap
  root((Event Data Chatbot))
    What it does
      Plain English queries
      Match reports
      Local database
    Tech stack
      Python
      Claude
      MCP
    Use cases
      Football stats Q&A
      Summary reports
      Local analysis
    Audience
      Developers
      Football analysts

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Ask plain-English questions about football match statistics without writing SQL.

VIBE 2

Get a structured match report by typing a match ID with the /summary command.

VIBE 3

Explore StatsBomb's open football dataset locally without needing a cloud database.

VIBE 4

Let Claude chain multiple queries together to answer a more complex football question.

what's the stack?

PythonClaudeMCPSQL

how it stacks up fr

parmacalcio1913/event-data-chatbotaevella/sky-pc-mcp-companionalicankiraz1/gemma-4-31b-mtp-vllm-server
Stars262626
LanguagePythonPythonPython
Setup difficultymoderatemoderatehard
Complexity3/53/54/5
Audiencedevelopervibe coderops devops

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Needs Python 3.10+, a paid Anthropic API key, and a roughly half-gigabyte StatsBomb dataset download.

The code is free to use for any purpose including commercial use, but the StatsBomb data itself requires attribution if you publish derived analysis.

in plain english

This project is a command-line chatbot that lets you ask plain-English questions about professional football match data. You type something like "Who scored the most goals in the 2015/2016 La Liga?" and the bot figures out what data to look up and gives you an answer, without you needing to write any database queries yourself. The data comes from StatsBomb, a football analytics company that publishes a free open dataset covering dozens of competitions and thousands of matches. The project downloads a local copy of that dataset (about half a gigabyte) and stores it in a database on your own machine. All queries run locally after that. Under the hood, the chatbot connects Claude, an AI model from Anthropic, to that local database through a system called MCP (Model Context Protocol). When you ask a question, Claude decides what data it needs, writes a SQL query internally, runs it against the database, reads the result, and then writes a plain-English answer back to you. You never see the SQL unless you turn on a debug flag. The same loop can run multiple queries in a row if your question requires it, for example first checking which competition names exist and then running a follow-up count. There is also a slash-command feature. Typing /summary followed by a match ID produces a structured match report for that specific game. The project includes tab completion so you can discover available commands by pressing Tab. To use it you need Python 3.10 or newer and an Anthropic API key, which requires a paid account with Anthropic. Setup involves cloning the repository, installing dependencies, downloading the StatsBomb snapshot, and adding your API key to a configuration file. The README includes step-by-step instructions for each of those steps. The code is released under the MIT license. The StatsBomb data itself is subject to a separate user agreement that requires attribution and display of the StatsBomb logo if you publish any analysis derived from it.

prompts (copy fr)

prompt 1
Set up the StatsBomb chatbot and ask who scored the most goals in the 2015/2016 La Liga.
prompt 2
Show me how to add my Anthropic API key to this chatbot's configuration.
prompt 3
Generate a /summary report for a specific match ID using this chatbot.
prompt 4
Explain how this chatbot uses MCP to query the StatsBomb database with Claude.

Frequently asked questions

what is event-data-chatbot fr?

A command-line chatbot that answers plain-English questions about football match data using Claude and a local StatsBomb dataset.

What language is event-data-chatbot written in?

Mainly Python. The stack also includes Python, Claude, MCP.

What license does event-data-chatbot use?

The code is free to use for any purpose including commercial use, but the StatsBomb data itself requires attribution if you publish derived analysis.

How hard is event-data-chatbot to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is event-data-chatbot for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.