https://github.com/shotgeek/shotgeek
ShotGeek is a data analytics platform powered by Django, specializing in NBA statistics and insights.
https://github.com/shotgeek/shotgeek
django nba-analytics python
Last synced: about 1 year ago
JSON representation
ShotGeek is a data analytics platform powered by Django, specializing in NBA statistics and insights.
- Host: GitHub
- URL: https://github.com/shotgeek/shotgeek
- Owner: ShotGeek
- License: apache-2.0
- Created: 2025-01-29T14:38:27.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2025-06-06T06:44:49.000Z (about 1 year ago)
- Last Synced: 2025-06-06T07:29:45.118Z (about 1 year ago)
- Topics: django, nba-analytics, python
- Language: Python
- Homepage: https://www.shotgeek.com/
- Size: 122 MB
- Stars: 3
- Watchers: 0
- Forks: 4
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# ShotGeek
## Table of Contents
1. [Introduction](#shotgeek)
2. [Features](#features)
3. [Getting Started](#getting-started)
- [Prerequisites](#prerequisites)
- [Installation](#installation)
4. [Usage](#usage)
- [Searching for a Player](#searching-for-a-player)
- [Comparing Players](#comparing-players)
- [Viewing Graphs](#viewing-graphs)
5. [Contributing](#contributing)
6. [License](#license)
## ShotGeek
ShotGeek is a Django web application that provides NBA stats, scores, and player comparisons. Whether you're a casual fan or a stats enthusiast, ShotGeek helps you explore player performance and compare careers with detailed tables and visualizations.
## Features
- **Player Search**: Look up any NBA player by full name to access their career statistics.
- **Career Stat Totals**: View detailed career stats for individual players.
- **Graphical Analysis**: Use interactive graphs to visualize player performance over time.
- **Player Comparison**: Compare two players' career stats side by side.
- **Customizable Views**: Select stat categories for table and graph comparisons.
## Getting Started
### Prerequisites
Ensure you have the following installed on your system:
- Python 3.9
- Django
- PostgreSQL
### Installation
1. Clone the repository:
```sh
git clone https://github.com/ShotGeek/ShotGeek.git
cd shotgeek
```
2. Create and activate a virtual environment:
```sh
python3.9 -m venv myenv
source myenv/bin/activate # On Windows use `venv\Scripts\activate`
```
3. Install dependencies:
```sh
pip install -r requirements.txt
```
4. Uncomment DEVELOPMENT=True in .env:
```vbnet
# .env
SECRET_KEY='django-insecure-enfgxe59+e1kt+c#unqrutb9y#_0)+aht&+@5@^r@pupks1wt8'
DEVELOPMENT=True
```
6. Set up the database:
```sh
python manage.py migrate
```
7. Run the development server:
```sh
python manage.py runserver
```
8. Open your browser and visit: `http://127.0.0.1:8000/`
## Usage
### Searching for a Player
- Enter the player's full name in the search bar.
- Ensure correct spelling to avoid incorrect results.
- Example: Searching for `Charles Barkley` will take you to his player page.
### Comparing Players
- Click the **Compare Players** button to access the comparison tool.
- Enter the full name of two players to compare their stats side by side.
- Select specific stat categories for in-depth analysis.
### Viewing Graphs
- Navigate to a player's page or the comparison page.
- Use the dropdown menu to select a stat category.
- The graph will display trends over the player's career.
## Contributing
We welcome contributions from the open-source community. If you find any issues or want to suggest enhancements, feel free to create a pull request or submit an issue.
For more information on contributing visit [Contributing](https://github.com/ShotGeek/ShotGeek/blob/master/CONTRIBUTING.md)
## License
ShotGeek is licensed under the [Apache License 2.0](LICENSE).