Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

♠ Felt Coach — Texas Hold'em Trainer

A zero-dependency web app that trains you for live casino cash games and tournaments: chart drills, pot-odds math, board reading, and full hands against realistic live-pool bots — with a coach that grades every decision you make, in numbers, and tells you what to work on next.

New here? Start at INDEX.md for the project map and code guide.

Run it

python3 serve.py

Open http://localhost:8788. (serve.py is a stock static server that just disables stale caching so updates appear on refresh — any static server works.) No build step, no network calls, no accounts. Progress lives in your browser's localStorage — back it up from Stats → Export.

What's inside

Mode What it trains
Drills → Preflop Opens Raise-or-fold from every seat, with a position diagram
Drills → Facing a Raise Fold / call / 3-bet vs opens by position
Drills → Pot Odds & Outs Outs counting and pricing calls — with a "teach me this spot" walkthrough that plugs the hand's real numbers into the formulas, plus a live calculator
Drills → Postflop Gym Dealt c-bet and draw-defense spots graded with live equity
Drills → Board Scan Read the board from the villain's side: what's chasing, and how often it arrives
Drills → Push/Fold Nash-approx short-stack jams by position/stack/antes
Cash Game 6/9-max vs Station/Rock/TAG/LAG/Maniac lineups. MXN stakes including 25/25 equal blinds, capped or uncapped (200–400bb) tables, 100–300bb buy-ins
Tournament 9-man SNG: rising blinds, BB antes, push/fold zone, live ICM at the bubble
Review Import real GGPoker histories (.zip / .txt / paste) — every decision replayed and graded, with pot, price, and equity shown on each flagged hand. Local-only
Theory 10 lessons with charts embedded, plus a chart browser: openings · facing raises · big-blind play · multi-raise pots & all-ins · push/fold, with a 9-max/6-max toggle
Stats Drill accuracy, leak counter, Coach's Report (weak spots from real play, linked to the drill that fixes each), sessions, export/import

The coach

Grades every decision: ✅ Best · 👍 Fine · ⚠️ Inaccuracy · ❌ Mistake · 💀 Blunder — with the numbers behind it and a leak tag. Set it to speak on every decision, only on mistakes, or stay silent until the hand review.

It also watches for patterns: repeat a leak in a session and a "📋 Pattern spotted" note appears; the end-of-session summary lists your top work items; the full diagnosis lives in Stats → Coach's report.

Table feel

Synthesized sounds (cards, chips, table knocks, win chimes — WebAudio, no files), optional Spanish table talk (paso / pago / subo / bote / tercia…) and table voices so bots and the dealer announce the action out loud in English or Mexican Spanish. All toggleable in Settings.

Honesty box

  • Preflop charts are simplified GTO baselines; push/fold is Nash-approximate.
  • The postflop coach is heuristics + Monte Carlo equity vs modeled ranges — a strong teacher, not a solver. Borderline spots are graded leniently on purpose.
  • Bots are archetype simulations of a live pool, not exploitative AI.
  • The practice tables deal rake-free; real rooms don't.

Tests

node tests/run.mjs   # 169 assertions across engine, strategy, review, import

Architecture and design decisions: SPEC.md.

About

Zero-dependency Texas Hold'em trainer: Monte Carlo equity engine, 7-card evaluator, NLHE state machine with side pots, ICM, and a coach that grades every decision with EV loss. No build step, no network calls.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages