https://github.com/eusha425/mlb-strategy-assistant
AI-Powered Baseball Strategy Analyser with real-time pitch explanations using MLB data & Gemini API. Includes Python & Streamlit, built for fans, analysts, and developers.
https://github.com/eusha425/mlb-strategy-assistant
ai-application api-integration gemini-api machine-learning mlb-api python real-time-analytics sports-analytics streamlit
Last synced: 3 months ago
JSON representation
AI-Powered Baseball Strategy Analyser with real-time pitch explanations using MLB data & Gemini API. Includes Python & Streamlit, built for fans, analysts, and developers.
- Host: GitHub
- URL: https://github.com/eusha425/mlb-strategy-assistant
- Owner: Eusha425
- License: mit
- Created: 2025-02-01T08:12:26.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-02-25T11:53:16.000Z (8 months ago)
- Last Synced: 2025-02-25T12:37:29.276Z (8 months ago)
- Topics: ai-application, api-integration, gemini-api, machine-learning, mlb-api, python, real-time-analytics, sports-analytics, streamlit
- Language: Python
- Homepage:
- Size: 42 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# ⚾ Baseball Strategy Assistant
*An AI-powered tool that explains baseball pitch strategies in real-time using MLB data and Google's Gemini API.*
[Features](#-features) •
[Installation](#-installation) •
[Usage](#-usage) •
[Project Structure](#-project-structure) •
[Contributing](#-contributing)
---
## 📋 Overview
The **Baseball Strategy Assistant** is a real-time AI tool that analyses MLB game data and provides casual fans with fun, easy-to-understand explanations of pitch strategies. Built with Python, Streamlit, and Google's Gemini API, it transforms complex baseball tactics into relatable analogies.
---
## 🚀 Features
- **Real-Time Insights**: Fetches live game data from MLB's API.
- **AI-Powered Analysis**: Uses Gemini to generate casual, fun explanations.
- **Interactive UI**: Built with Streamlit for a clean, user-friendly experience.
- **Multilingual Support**: Gemini can explain strategies in multiple languages.
- **Historical Data**: Works with past games for demo purposes.
---
## 🛠️ Prerequisites
- Python 3.9+
- Google Gemini API Key ([Get it here](https://ai.google.dev/))
- MLB API Access (Public, no key required)
---
## 🚀 Installation & Setup
1. **Clone the repository**
```bash
git clone https://github.com/Eusha425/baseball-strategy-assistant.git
cd baseball-strategy-assistant
```
2. **Set up a virtual environment**
```bash
python -m venv .venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
```
3. **Install dependencies**
```bash
pip install -r requirements.txt
```
4. **Set up environment variables**
Create a `.env` file in the root directory:
```env
GEMINI_API_KEY=your_api_key_here
```
---
## 📊 Usage
1. **Run the app locally**
```bash
streamlit run main.py
```
2. **View the app**
Open your browser and navigate to `http://localhost:8501`.
3. **Interact with the app**
- The app automatically fetches live game data.
- If no live games are available, it uses historical data for demonstration.
- View real-time pitch insights with fun analogies!
---
## 📁 Project Structure
```
baseball-strategy-assistant/
├── main.py # Streamlit app entry point
├── mlb_client/ # MLB API interactions
│ └── __init__.py
├── gemini_client/ # Gemini API integration
│ └── __init__.py
├── date_utils/ # Date-related utilities
│ └── __init__.py
├── .env # Environment variables
├── requirements.txt # Python dependencies
└── README.md # Project documentation
```
---
## 📈 Performance
- **Latency**:
- MLB API: ~200ms
- Gemini API: ~500ms
- **Supported Games**:
- Live MLB games (when available)
- Historical games (fallback)
---
## 🤝 Contributing
We welcome contributions! Here’s how you can help:
1. **Report Bugs**: Open an issue with detailed steps to reproduce.
2. **Suggest Features**: Share your ideas for new features or improvements.
3. **Submit Pull Requests**: Follow our [Contributing Guidelines](CONTRIBUTING.md).
---
## 📜 License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
---
## ✨ Acknowledgments
- **MLB API**: For providing free access to live game data.
- **Google Gemini**: For enabling AI-powered insights.
- **Streamlit**: For making web app development simple and fast.