CFB Dynasty Data

A comprehensive dynasty roster management and valuation tool for College Football 25, featuring automated player analysis, recruiting planning, and roster generation.

Quick Start

Installation

git clone https://github.com/your-username/CFB-Dynasty-Data.git
cd CFB-Dynasty-Data
python -m venv .venv
source . ./venv/bin/activate  # Windows: . .\venv\Scripts\activate
pip install -r requirements.txt

Basic Usage

This package is best run as a notebook. I'll be adding more notes here for alternative usage in the coming months.

Features

• Player Valuation: Calculate player value based on rating, development traits, and remaining eligibility
• Roster Analysis: Comprehensive position-by-position strength evaluation
• Recruiting Intelligence: Automated identification of recruiting priorities and scheme fit analysis
• Dynasty Management: Year-over-year roster progression with automatic player advancement

Project Structure

• cfb_dynasty/ - Main package with models, analysis, and utilities
• scripts/ - Executable scripts for automated processing
• notebooks/ - Interactive Jupyter analysis notebooks
• tests/ - Test suite
• docs/ - Detailed documentation

Testing

python -m pytest tests/ -v

Documentation

See docs/README.md for comprehensive documentation including:

• Detailed API reference
• Configuration options
• File format specifications
• Development guidelines

Contributing

1. Fork the repository
2. Create a feature branch
3. Add tests for new functionality
4. Ensure all tests pass
5. Submit a pull request