Automated Scouting Reports

A Python project for generating pitcher scouting reports using Baseball Savant / Statcast data, cleaned datasets, and visualizations.

This project was built as a starter workflow for pulling pitcher data, processing it, creating summary visuals, and eventually producing automated scouting reports.

Current Status

This is a Version 1 project. It currently includes scripts for:

• Pulling pitcher data
• Cleaning and processing pitch-level data
• Creating visualizations
• Generating report outputs
• Testing the workflow through notebooks

The project is still in development and will continue to be improved as the report format, visuals, and analysis become more advanced.

Project Structure

Automated_Scouting_Reports/
├── README.md
├── requirements.txt
├── data/
│   ├── raw/
│   └── processed/
├── outputs/
│   ├── reports/
│   └── visuals/
├── src/
│   ├── __init__.py
│   ├── pull_data.py
│   ├── process_data.py
│   ├── analyze_pitching.py
│   ├── create_visuals.py
│   └── generate_report.py
├── batch_reports.ipynb
└── test_setup.ipynb.ipynb

Install

Install the required Python packages with:

pip install -r requirements.txt

First Run Example

Example command:

python src/pull_data.py --pitcher "Gerrit Cole" --start-date 2025-03-01 --end-date 2025-10-01

This command is intended to:

1. Look up the MLBAM player ID for the pitcher
2. Pull Statcast pitcher-level pitch-by-pitch data
3. Save a raw CSV file into data/raw/

Main Files

File	Purpose
src/pull_data.py	Pulls pitcher data from Baseball Savant / Statcast
src/process_data.py	Cleans and prepares raw data for analysis
src/analyze_pitching.py	Builds pitching summaries and analysis tables
src/create_visuals.py	Creates scouting report visuals
src/generate_report.py	Generates the final report output
batch_reports.ipynb	Notebook for testing multiple reports
requirements.txt	Lists required Python packages

Next Steps

Planned improvements include:

• Improve the visual design of the scouting reports
• Add clearer pitch-type summaries
• Add count-based and handedness-based splits
• Build a repeatable batch report workflow
• Create portfolio-ready example reports
• Add more documentation for beginners

Notes

This repository is currently private while the project is being developed and cleaned up.