project 001 (odds2beat)

Pick a game. Get the intel. Make smarter bets.

A CLI tool that pulls live odds from 80+ bookmakers, researches injuries, form, head-to-head records, and fixture congestion. Then, uses an LLM to generate a structured betting intel briefing.

You still decide. This just makes you the most informed person looking at the game.

---

How it works

python main.py

1. Browse all in-season sports
2. Select a match
3. Odds are pulled from bookmakers via The Odds API
4. An AI agent searches for injuries, form, H2H, schedules, and predictions
5. You get a structured intel briefing

---

Setup

Clone & install:

git clone https://github.com/addaia/odds2beat.git
cd odds2beat
python -m venv o2b
# Windows
.\o2b\Scripts\activate
# Mac/Linux
source o2b/bin/activate
pip install -r requirements.txt

Add your API keys:

cp .env.example .env

Edit .env with your keys:

ODDS_API_KEY=your_key
TAVILY_API_KEY=your_key
CEREBRAS_API_KEY=your_key

Service	What it does	Free tier	Get a key
The Odds API	Live odds from 80+ bookmakers	500 credits/mo	Sign up
Tavily	Web search for research	1000 searches/mo	Sign up
Cerebras	LLM reasoning	Free tier	Sign up

---

Example output

Select sport: La Liga
Select game: Athletic Bilbao vs Barcelona

Fetching odds from 30+ bookmakers...
Researching...
Analyzing...

============================================================
  INTEL BRIEFING
============================================================

## MATCH CONTEXT
Barcelona (1st, 64 pts) travel to Athletic Bilbao (9th, 35 pts)...

## KEY ABSENCES
- Jules Kounde (hamstring) — OUT
- Alejandro Balde (hamstring) — OUT
- Nico Williams (pubalgia) — OUT indefinitely
- Lewandowski (fractured eye socket) — training with mask, DOUBTFUL

## FIXTURE CONGESTION
Athletic last played Wed 4 Mar (Copa del Rey).
Barcelona play Newcastle in UCL on Tue 10 Mar — expect rotation.

## BETTING ANGLES
Value on BTTS at 1.56 — Athletic have scored in 4 of last 5 home games...

Output condensed for display. Actual briefings are more detailed.

---

Project structure

odds2beat/
├── main.py          ← run this — the full flow
├── odds.py          ← odds API client
├── agent.py         ← research + LLM briefing
├── .env.example     ← API key template
├── requirements.txt
└── README.md

---

License

MIT

---

Built by Alex Lindley Morodo