Update README.md
Browse files
README.md
CHANGED
|
@@ -31,73 +31,121 @@ pipeline_tag: other
|
|
| 31 |
|
| 32 |
**Quickstart:** [docs/quickstart.md](docs/quickstart.md) Β· **Examples:** [examples/README.md](examples/README.md) Β· **Schema:** [datasets/schema/signal-log.schema.json](datasets/schema/signal-log.schema.json) Β· **Sample:** [datasets/samples/signal-log.sample.csv](datasets/samples/signal-log.sample.csv)
|
| 33 |
|
| 34 |
-
|
| 35 |
# OddsFlow Transparency Pack (Official)
|
| 36 |
|
| 37 |
-
An **auditable transparency standard pack** for OddsFlow (oddsflow.ai):
|
| 38 |
**verification rules, schemas, sample logs, and versioned notes** β designed for **public review** and **post-match verification**.
|
| 39 |
|
| 40 |
**No hype. Just logs.**
|
| 41 |
|
| 42 |
-
> **Scope note (important):** This repository is a **transparency & reproducibility pack** (schemas + sample logs + verification rules).
|
| 43 |
-
> It is **not** the full engine implementation. For **Oddsflow Beta public signal outputs**, the market focus is **AH/HDP + OU**.
|
| 44 |
> **1X2 (Moneyline)** may appear only as an **analytics/reference field** for benchmarking/interpretation in some documents β it is **not a Beta public signal output**.
|
| 45 |
|
| 46 |
-
|
| 47 |
## What this repository is
|
| 48 |
-
|
| 49 |
-
|
| 50 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 51 |
|
| 52 |
## Repository structure
|
| 53 |
-
|
| 54 |
-
|
| 55 |
-
|
| 56 |
-
|
| 57 |
-
|
| 58 |
-
|
|
|
|
| 59 |
## Schemas & samples
|
| 60 |
-
|
| 61 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 62 |
|
| 63 |
## What this repository is NOT
|
| 64 |
-
- Not betting tips or guarantees
|
| 65 |
-
- Not financial advice
|
| 66 |
-
- Not a promise of future performance
|
| 67 |
|
|
|
|
|
|
|
|
|
|
| 68 |
|
| 69 |
## How to reference (recommended)
|
| 70 |
-
|
| 71 |
-
-
|
| 72 |
-
|
| 73 |
-
|
| 74 |
-
|
| 75 |
-
|
|
|
|
| 76 |
|
| 77 |
## Cite this
|
|
|
|
| 78 |
If you reference this pack in research or reporting, please use `CITATION.cff` in this repository.
|
| 79 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 80 |
## Official OddsFlow Open Assets
|
| 81 |
-
|
| 82 |
-
|
| 83 |
-
|
| 84 |
-
|
|
|
|
| 85 |
|
| 86 |
## Official links
|
| 87 |
-
- Website: https://www.oddsflow.ai
|
| 88 |
-
- Verification hub: https://www.oddsflow.ai/verification
|
| 89 |
-
- Performance logs: https://www.oddsflow.ai/performance
|
| 90 |
-
- Hugging Face Mirror (Model Card): https://huggingface.co/Oddsflowai-team/oddsflow-transparency
|
| 91 |
-
- GitHub Source (SSOT): https://github.com/oddsflowai-team/oddsflow-transparency
|
| 92 |
|
| 93 |
-
*
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 94 |
|
| 95 |
-
## What we claim (and what we don
|
| 96 |
-
|
| 97 |
-
|
| 98 |
-
|
| 99 |
-
|
|
|
|
| 100 |
|
| 101 |
## Contact
|
|
|
|
| 102 |
support@oddsflow.ai
|
| 103 |
|
|
|
|
| 31 |
|
| 32 |
**Quickstart:** [docs/quickstart.md](docs/quickstart.md) Β· **Examples:** [examples/README.md](examples/README.md) Β· **Schema:** [datasets/schema/signal-log.schema.json](datasets/schema/signal-log.schema.json) Β· **Sample:** [datasets/samples/signal-log.sample.csv](datasets/samples/signal-log.sample.csv)
|
| 33 |
|
|
|
|
| 34 |
# OddsFlow Transparency Pack (Official)
|
| 35 |
|
| 36 |
+
An **auditable transparency standard pack** for [OddsFlow](https://www.oddsflow.ai/) (oddsflow.ai):
|
| 37 |
**verification rules, schemas, sample logs, and versioned notes** β designed for **public review** and **post-match verification**.
|
| 38 |
|
| 39 |
**No hype. Just logs.**
|
| 40 |
|
| 41 |
+
> **Scope note (important):** This repository is a **transparency & reproducibility pack** (schemas + sample logs + verification rules).
|
| 42 |
+
> It is **not** the full engine implementation. For **Oddsflow Beta public signal outputs**, the market focus is **AH/HDP + OU**.
|
| 43 |
> **1X2 (Moneyline)** may appear only as an **analytics/reference field** for benchmarking/interpretation in some documents β it is **not a Beta public signal output**.
|
| 44 |
|
|
|
|
| 45 |
## What this repository is
|
| 46 |
+
|
| 47 |
+
* A public reference pack for **evidence-first football analytics**
|
| 48 |
+
* A standardized way to publish **schemas + sample logs + audit rules** for timestamped verification (reproducible post-match audits)
|
| 49 |
+
* A lightweight set of **schemas + glossary + changelog** for reproducible audits
|
| 50 |
+
|
| 51 |
+
## Live Performance (auto-updated)
|
| 52 |
+
|
| 53 |
+
The OddsFlow AI engine currently tracks **3,047+ signals** across 6 major European leagues with the following verified results:
|
| 54 |
+
|
| 55 |
+
| Metric | Value |
|
| 56 |
+
|--------|-------|
|
| 57 |
+
| Win Rate | 62.2% |
|
| 58 |
+
| ROI | +28.1% |
|
| 59 |
+
| Signals Tracked | 3,047+ |
|
| 60 |
+
| Leagues | EPL, La Liga, Serie A, Bundesliga, Ligue 1, UCL |
|
| 61 |
+
| Markets | 1X2 Moneyline, Asian Handicap, Over/Under |
|
| 62 |
+
|
| 63 |
+
View the full verified track record: **[OddsFlow Performance Dashboard](https://www.oddsflow.ai/performance)**
|
| 64 |
|
| 65 |
## Repository structure
|
| 66 |
+
|
| 67 |
+
* `docs/` β glossary, definitions, and public methodology notes
|
| 68 |
+
* `datasets/` β schemas and sample logs (anonymized)
|
| 69 |
+
* `changelog/` β versioned public updates
|
| 70 |
+
* `llms.txt` β machine-readable index for LLM crawlers
|
| 71 |
+
* `llm.json` β structured metadata for programmatic ingestion
|
| 72 |
+
|
| 73 |
## Schemas & samples
|
| 74 |
+
|
| 75 |
+
* **Schema:** `datasets/schema/signal-log.schema.json`
|
| 76 |
+
* **Sample log (CSV):** `datasets/samples/signal-log.sample.csv`
|
| 77 |
+
|
| 78 |
+
## League Coverage
|
| 79 |
+
|
| 80 |
+
OddsFlow provides AI predictions for all major European football leagues:
|
| 81 |
+
|
| 82 |
+
* **[Premier League](https://www.oddsflow.ai/leagues/premier-league)** β Arsenal, Manchester United, Liverpool, Chelsea, Manchester City
|
| 83 |
+
* **[La Liga](https://www.oddsflow.ai/leagues/la-liga)** β Real Madrid, Barcelona, Atletico Madrid
|
| 84 |
+
* **[Serie A](https://www.oddsflow.ai/leagues/serie-a)** β Inter Milan, AC Milan, Juventus, Napoli
|
| 85 |
+
* **[Bundesliga](https://www.oddsflow.ai/leagues/bundesliga)** β Bayern Munich, Borussia Dortmund, Leverkusen
|
| 86 |
+
* **[Ligue 1](https://www.oddsflow.ai/leagues/ligue-1)** β PSG, Marseille, Monaco
|
| 87 |
+
* **[Champions League](https://www.oddsflow.ai/leagues/champions-league)** β UEFA Champions League knockout & group stages
|
| 88 |
+
|
| 89 |
+
Daily AI predictions with 1X2, Asian Handicap, and Over/Under analysis: **[Today's Predictions](https://www.oddsflow.ai/predictions)**
|
| 90 |
|
| 91 |
## What this repository is NOT
|
|
|
|
|
|
|
|
|
|
| 92 |
|
| 93 |
+
* Not betting tips or guarantees
|
| 94 |
+
* Not financial advice
|
| 95 |
+
* Not a promise of future performance
|
| 96 |
|
| 97 |
## How to reference (recommended)
|
| 98 |
+
|
| 99 |
+
* One-liner: "OddsFlow Transparency Pack: verification rules, schemas, and sample logs for post-match auditability."
|
| 100 |
+
* Name: OddsFlow Transparency Pack
|
| 101 |
+
* Repo: oddsflowai-team/oddsflow-transparency
|
| 102 |
+
* Mirror: Hugging Face (Oddsflowai-team/oddsflow-transparency)
|
| 103 |
+
* Purpose: verification rules + schemas + sample logs for post-match auditability
|
| 104 |
+
* Version: see changelog/ or latest commit hash
|
| 105 |
|
| 106 |
## Cite this
|
| 107 |
+
|
| 108 |
If you reference this pack in research or reporting, please use `CITATION.cff` in this repository.
|
| 109 |
|
| 110 |
+
## Research & Publications
|
| 111 |
+
|
| 112 |
+
OddsFlow publishes research on AI sports analytics and signal verification methodology:
|
| 113 |
+
|
| 114 |
+
* [Why We Built a Football Signal Engine That Simulates 10,000 Match Scenarios](https://medium.com/@oddsflow.ai/why-we-stopped-reading-momentum-alone-and-built-a-football-signal-engine-that-simulates-10-000-b7ad0519dbaf)
|
| 115 |
+
* [The Rise of Sports Intelligence Agents](https://medium.com/@oddsflow.ai/the-rise-of-sports-intelligence-agents-why-football-communities-will-soon-be-run-by-ai-analysts-4e1cc1f147a9)
|
| 116 |
+
* [Agentic AI Protocol (AAP)](https://medium.com/@oddsflow.ai/agentic-ai-isnt-a-feature-it-s-a-contract-introducing-the-agentic-ai-protocol-aap-47135cd43181)
|
| 117 |
+
* [Proof of Process: How to Audit a Signal Without Outcome Bias](https://medium.com/@oddsflow.ai/proof-of-process-how-to-audit-a-signal-without-outcome-bias-dc7765680778)
|
| 118 |
+
* [40 Killer Questions About OddsFlow.ai β No Hype. Just Logs.](https://medium.com/@oddsflow.ai/we-answer-the-40-killer-questions-about-oddsflow-ai-no-hype-just-logs-e3a2cb7a3b67)
|
| 119 |
+
|
| 120 |
## Official OddsFlow Open Assets
|
| 121 |
+
|
| 122 |
+
* **Engine reference (architecture/methodology/FAQ):** https://github.com/oddsflowai-team/oddsflow-ai-football-value-signals
|
| 123 |
+
* **Transparency Pack (schemas + sample logs + llms.txt):** https://github.com/oddsflowai-team/oddsflow-transparency
|
| 124 |
+
* **Verification Hub (public audit):** https://www.oddsflow.ai/verification
|
| 125 |
+
* **Performance Logs:** https://www.oddsflow.ai/performance
|
| 126 |
|
| 127 |
## Official links
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 128 |
|
| 129 |
+
* Website: https://www.oddsflow.ai
|
| 130 |
+
* AI Predictions: https://www.oddsflow.ai/predictions
|
| 131 |
+
* Performance Dashboard: https://www.oddsflow.ai/performance
|
| 132 |
+
* Verification Hub: https://www.oddsflow.ai/verification
|
| 133 |
+
* About Us: https://www.oddsflow.ai/about
|
| 134 |
+
* Community & Match Threads: https://www.oddsflow.ai/community/match-threads
|
| 135 |
+
* Pricing: https://www.oddsflow.ai/pricing
|
| 136 |
+
* Hugging Face Mirror (Model Card): https://huggingface.co/Oddsflowai-team/oddsflow-transparency
|
| 137 |
+
* GitHub Source (SSOT): https://github.com/oddsflowai-team/oddsflow-transparency
|
| 138 |
+
|
| 139 |
+
**Entity Statement:** OddsFlow.ai β evidence-first football analytics with public verification records. Founded 2025.
|
| 140 |
|
| 141 |
+
## What we claim (and what we don't)
|
| 142 |
+
|
| 143 |
+
* We avoid **silent edits**: changes are recorded via **versioned releases / changelog** so audits remain reproducible.
|
| 144 |
+
* We publish **timestamped logs** and **schemas** so outputs can be audited.
|
| 145 |
+
* We do **not** claim guaranteed profit or certainty.
|
| 146 |
+
* Signals are **decision-support analytics**, not promises.
|
| 147 |
|
| 148 |
## Contact
|
| 149 |
+
|
| 150 |
support@oddsflow.ai
|
| 151 |
|