{"id":36795996,"url":"https://github.com/efischer19/hoopstat-haus","last_synced_at":"2026-01-12T13:30:00.586Z","repository":{"id":303955436,"uuid":"1016177789","full_name":"efischer19/hoopstat-haus","owner":"efischer19","description":"A GenAI-powered data lakehouse for NBA/WNBA stats. Ingests, processes, and provides insights for predictive analytics and semantic search. Built with Python, robust backend infra, and deployed via GH Actions. Your go-to for advanced hoops data!","archived":false,"fork":false,"pushed_at":"2026-01-02T13:35:52.000Z","size":3053,"stargazers_count":2,"open_issues_count":4,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-02T13:37:34.328Z","etag":null,"topics":["ai-assisted-development","aws","basketball","data-analytics","data-engineering","devops","docker","github-actions","gplv3","machine-learning","monorepo","nba","open-data","open-source","poetry","python","serverless","software-craftsmanship","sports-analytics","terraform"],"latest_commit_sha":null,"homepage":"https://hoopstat.haus","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/efischer19.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-08T15:50:26.000Z","updated_at":"2026-01-02T12:46:38.000Z","dependencies_parsed_at":"2025-09-24T15:22:30.941Z","dependency_job_id":null,"html_url":"https://github.com/efischer19/hoopstat-haus","commit_stats":null,"previous_names":["efischer19/hoopstat-haus"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/efischer19/hoopstat-haus","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/efischer19%2Fhoopstat-haus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/efischer19%2Fhoopstat-haus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/efischer19%2Fhoopstat-haus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/efischer19%2Fhoopstat-haus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/efischer19","download_url":"https://codeload.github.com/efischer19/hoopstat-haus/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/efischer19%2Fhoopstat-haus/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28339118,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-12T12:22:26.515Z","status":"ssl_error","status_checked_at":"2026-01-12T12:22:10.856Z","response_time":98,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-assisted-development","aws","basketball","data-analytics","data-engineering","devops","docker","github-actions","gplv3","machine-learning","monorepo","nba","open-data","open-source","poetry","python","serverless","software-craftsmanship","sports-analytics","terraform"],"created_at":"2026-01-12T13:29:59.974Z","updated_at":"2026-01-12T13:30:00.578Z","avatar_url":"https://github.com/efischer19.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Hoopstat Haus 🏀\n\n[![Status: WIP](https://img.shields.io/badge/status-work_in_progress-yellow.svg)](https://github.com/efischer19/hoopstat-haus)\n\nA GenAI-powered data lakehouse for NBA/WNBA stats. Your go-to for advanced hoops data!\n\n---\n\n\u003e **Note:** This project is currently under active development and is not yet functional. The infrastructure and core components are being built. Please check back for updates!\n\n## 🚀 Quick Start: Access Basketball Analytics (Stateless JSON)\n\nPer ADR-027, initial public access is provided via small, precomputed JSON artifacts served directly from S3. No auth required.\n\n### What’s available\n- player_daily: per-player daily metrics\n- team_daily: per-team daily metrics\n- top_lists: curated top metrics (e.g., top_ts, top_per, top_efg, top_net)\n- index/latest.json: pointer to the most recent available dates\n\nAll artifacts are versioned (v1) and capped at ~100 KB for fast, low-cost access.\n\n### 📊 Data Availability\n- Coverage: 2023-24 NBA season onwards\n- Updates: Daily, 2–4 hours after games complete\n- Format: JSON artifacts under gold/served/\n- Access: Public S3 with CORS (CDN optional)\n\nNote: An MCP adapter may be added later as an optional layer. See meta/plans/v2-architecture-diagram.md.\n\n## About The Project\n\nHoopstat Haus is an open-source project aimed at creating a comprehensive data lakehouse for basketball analytics. It ingests and processes NBA/WNBA statistics to provide deep insights for predictive modeling and powerful semantic search.\n\nThe core mission is to leverage modern data infrastructure and Generative AI to make advanced basketball analysis accessible and powerful.\n\n## Tech Stack\n\nThis project is being built with a focus on robust, modern backend infrastructure:\n\n* **Language:** Python\n* **Core Functionality:** Data Ingestion, Processing, and Predictive Analytics\n* **Deployment:** Fully automated via GitHub Actions\n\n## Current Status\n\nThe repository has been seeded with foundational documents and architectural principles. The next phase of development will focus on building the core data ingestion pipelines.\n\nThe project is **not operational** at this time.\n\n## Repository Structure\n\n```\napps/           # Individual applications\nlibs/           # Shared Python libraries  \ninfrastructure/ # Terraform AWS infrastructure (includes ECR)\ndocs-src/       # Documentation source (MkDocs with Material theme)\nscripts/        # Utility scripts (ECR helper, etc.)\nmeta/           # Project metadata and ADRs\ntemplates/      # Project templates\n```\n\nKey infrastructure components:\n- **AWS ECR**: Container registry with automated CI/CD integration\n- **GitHub Actions**: Automated testing, building, and deployment\n- **Terraform**: Infrastructure as code for AWS resources\n\n## Contributing\n\nWhile the core infrastructure is being established, contributions are welcome in the form of ideas, feature requests, and bug reports. Please see our **[Contributing Guidelines](.github/CONTRIBUTING.md)** for more details on how you can help shape the future of Hoopstat Haus.\n\n### Quality Assurance for Contributors\n\nTo maintain code quality and reduce review cycles, please run local quality checks before submitting pull requests:\n\n```bash\n# For Python projects (apps and libs)\n./scripts/local-ci-check.sh apps/your-app\n./scripts/local-ci-check.sh libs/your-lib\n```\n\n**Optional**: Set up pre-commit hooks to automatically run quality checks:\n```bash\npip install pre-commit\npre-commit install\n```\n\nThis ensures your code passes the same checks that CI runs, catching formatting and linting issues early.\n\n### Documentation\n\nThis project uses [MkDocs with Material theme](https://squidfunk.github.io/mkdocs-material/) for documentation. All documentation is authored in `docs-src/` and automatically published to GitHub Pages.\n\n**Local Documentation Development:**\n```bash\n# Install documentation dependencies\npip install -r docs-requirements.txt\n\n# Build documentation (includes API docs generation)\n./scripts/build-docs.sh\n\n# Serve documentation locally\nmkdocs serve\n```\n\nThe documentation site will be available at `http://localhost:8000` for local preview.\n\n**Documentation Structure:**\n- Library API documentation is automatically generated from docstrings\n- Development guides and ADRs are manually authored in `docs-src/`\n- Documentation is published to: https://efischer19.github.io/hoopstat-haus/\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fefischer19%2Fhoopstat-haus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fefischer19%2Fhoopstat-haus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fefischer19%2Fhoopstat-haus/lists"}