Llama12315/football-data-hub-space
0
HF Football Data Hub Phase 1 MVP
A free-Hugging-Face-compatible data layer for the Hermes football prediction system.
This project migrates only the data acquisition / compact packet layer:
- Titan007 compact/raw fetch
- multi-company ADI/SFI/convergence analysis
- K-line compact summary
- compact packet API
- optional HF Dataset persistence
- Hermes client with local fallback support
It does not migrate:
- final_pick
- strongmodelreview
- bankroll_records
- MATCHTRACKERMASTER
- case_memory
- postmatchreviews
Those remain in Hermes local execution.
Free HF Architecture
External trigger / Hermes keepalive / GitHub Actions
-> HF Space API
-> vendor Hermes fetch scripts
-> compact_match_packet
-> local cache + optional HF Dataset upload
-> Hermes hf_data_client.pyNo HF Jobs are required for Phase 1.
Endpoints
GET /healthGET /hot-matches?date_=YYYY-MM-DDPOST /hot-matchesGET /match-packet?match_id=...&date_=YYYY-MM-DDGET /crow-screener?match_id=...&date_=YYYY-MM-DD(Dataset-only, data-only)POST /refresh-matchGET /source-status
Local run
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
uvicorn app:app --host 0.0.0.0 --port 7860Tests
pip install -r requirements.txt pytest
pytest -q