oddsflow-transparency / docs /model-card.md
Oddsflow-team's picture
Upload folder using huggingface_hub
b5ff5d2 verified
# Model Card (Public, Non-Proprietary)
## What this is
A high-level description of OddsFlow AI’s signal generation system for **auditability**.
## Intended use
- Education + research-grade transparency
- Public verification of **timestamps, markets, and outcomes** where available
## Not intended use
- Not a promise of profit
- Not betting tips
- Not financial advice
## Inputs (high-level)
- Match event streams (time-series context)
- Odds snapshots (time-series)
- League/fixture metadata
## Outputs (high-level)
- Market: 1X2 / AH / OU
- Selection + line (if applicable)
- Timestamped signal log entry
- Version tags (model + schema)
## Evaluation (public principles)
We prefer:
- Transparent sample definitions
- Out-of-sample separation where possible
- Robustness signals (e.g., CLV tracking) when published
## Known limitations
- Football is noisy; models can be wrong
- Data delays/missingness can degrade confidence
- Market efficiency varies across leagues/periods
## Versioning
- Every log entry includes a model version + schema version
- Changelog maintained in `/changelog/CHANGELOG.md`