
 ╔══════════════════════════════════════════════════════════════════════════╗
 ║                                                                          ║
 ║     ♠  ♥  ♦  ♣      R E A L T I M E   P O K E R   C A L C U L A T O R   ║
 ║                                                                          ║
 ║                    Real-Time Poker Equity Calculator                     ║
 ║                                                                          ║
 ║                            [  v 1 . 1 . 0  ]                             ║
 ║                                                                          ║
 ╚══════════════════════════════════════════════════════════════════════════╝

 ──────────────────────────────────────────────────────────────────────────────
                              R E L E A S E   I N F O
 ──────────────────────────────────────────────────────────────────────────────

   Name ............ : RealtimePokerCalculator
   Version ......... : 1.1.0
   Type ............ : Windows Standalone Application (Portable)
   Platform ........ : Windows 10 / 11 (x64)
   Packer .......... : PyInstaller (Single .EXE, no installer required)
   Language ........ : English
   Game Variants ... : Texas Hold'em, Omaha
   Protection ...... : None
   Files ........... : 1 x EXE + Settings + README
   Category ........ : Tools / Poker / AI

 ──────────────────────────────────────────────────────────────────────────────
                              A B O U T
 ──────────────────────────────────────────────────────────────────────────────

   RealtimePokerCalculator is a powerful real-time poker equity calculator
   that works while you play. It captures your poker table screen, automa-
   tically recognizes your hole cards and community cards using advanced
   AI vision (Anthropic Claude / OpenAI GPT-4o) or local computer vision
   (OpenCV + Tesseract OCR), and instantly calculates your hand equity
   through Monte Carlo simulation.

   No more alt-tabbing to equity calculators. No more manual card entry.
   One click - and you get Win%, Loss%, Tie% in seconds.

 ──────────────────────────────────────────────────────────────────────────────
                              F E A T U R E S
 ──────────────────────────────────────────────────────────────────────────────

   [+]  REAL-TIME SCREEN CAPTURE
        One click captures your active poker table. Zero manual input.

   [+]  AI-POWERED CARD RECOGNITION
        - Claude Sonnet 4.6     (recommended, excellent accuracy)
        - Claude Haiku  4.5     (fast, affordable)
        - Claude Opus   4.6     (maximum accuracy)
        - OpenAI GPT-4o         (high accuracy alternative)
        - OpenAI GPT-4o Mini    (budget-friendly)
        - Local CV              (offline, free, no API key needed)

   [+]  MONTE CARLO EQUITY SIMULATION
        Up to 15,000+ iterations by default. Configurable for speed
        vs. accuracy tradeoff. Outputs Equity%, Win%, Loss%, Tie%.

   [+]  AUTO-DETECTED HAND DATA
        Hero cards, board cards, current street (preflop/flop/turn/river),
        number of players, pot size, hero stack and table position.

   [+]  GAME VARIANTS
        Texas Hold'em (2 hole cards) and Omaha (4 hole cards).

   [+]  DARK THEMED UI
        Sleek, modern, non-intrusive layout designed for poker players.

   [+]  PORTABLE
        Single .EXE file. No installation. No background services.

   [+]  CUSTOMIZABLE
        Configure your own API keys, iteration count, preferred AI model,
        and default game variant through built-in Settings.

 ──────────────────────────────────────────────────────────────────────────────
                          I N S T A L L A T I O N
 ──────────────────────────────────────────────────────────────────────────────

   1. Extract the archive to any folder you like.
   2. Run RealtimePokerCalculator.exe - no installer needed.
   3. (Optional) Open Settings (gear icon) and paste your own
      Anthropic and/or OpenAI API keys for AI vision modes.
   4. (Optional) For Local CV mode, install Tesseract OCR:
      https://github.com/UB-Mannheim/tesseract/wiki

   The .exe is fully portable - everything (settings, cache) stays in
   the folder next to the executable. Move it, copy it, run it from USB.

 ──────────────────────────────────────────────────────────────────────────────
                                U S A G E
 ──────────────────────────────────────────────────────────────────────────────

   1. Launch RealtimePokerCalculator.exe
   2. Open Google Chrome and start playing at any online poker client
      (browser-based clients work best - screen capture grabs the
       focused Chrome window).
   3. When you want to know your equity, click [ Calculate ]
   4. The app captures your screen, sends it to the chosen AI model
      (or processes it locally via OpenCV/Tesseract), and runs a
      Monte Carlo simulation.
   5. Results appear in the dark UI panel:

         Equity:  64.7%       Win:  61.2%
                              Loss: 32.8%
                              Tie:   3.5%

         Hero:    A♠ K♣
         Board:   Q♠ J♦ 7♥
         Street:  Flop
         Players: 4

 ──────────────────────────────────────────────────────────────────────────────
                       S Y S T E M   R E Q U I R E M E N T S
 ──────────────────────────────────────────────────────────────────────────────

   - Windows 10 or later (x64)
   - Google Chrome (for screen capture of browser-based poker clients)
   - Internet connection (for cloud AI models)
   - ~ 200 MB free disk space
   - Optional: Tesseract OCR (only required for offline Local CV mode)

 ──────────────────────────────────────────────────────────────────────────────
                         A V A I L A B L E   A L S O   A S
 ──────────────────────────────────────────────────────────────────────────────

   - Google Chrome Extension (separate release)
   - Python source build (developer install)

 ──────────────────────────────────────────────────────────────────────────────
                              N O T E S
 ──────────────────────────────────────────────────────────────────────────────

   - Cloud AI modes (Claude / GPT-4o) require valid API keys. The app
     ships with optional default keys for first-launch testing; for any
     serious use you should plug in your OWN keys from:

         Anthropic : console.anthropic.com/settings/keys
         OpenAI    : platform.openai.com/api-keys

   - Local CV mode is completely free and offline. Accuracy is lower
     than the AI models but more than enough for clean, high-contrast
     poker tables.

   - API keys are stored ONLY in your local settings.json. Nothing is
     uploaded anywhere except the cropped table image to the AI vendor
     you pick (Anthropic or OpenAI).

 ──────────────────────────────────────────────────────────────────────────────
                          D I S C L A I M E R
 ──────────────────────────────────────────────────────────────────────────────

   This software is provided AS IS, for EDUCATIONAL and RECREATIONAL use
   only. The author makes no guarantees regarding accuracy of equity
   calculations or card recognition.

   It is YOUR responsibility to comply with the Terms of Service of any
   poker platform you use. Some online poker sites prohibit third-party
   assistance tools at the table - check before you use it on cash games
   or tournaments. Always gamble responsibly.

 ──────────────────────────────────────────────────────────────────────────────

                          ♠   ♥   ♦   ♣

                Thanks for trying RealtimePokerCalculator.
                       Good luck at the tables!

                          ♣   ♦   ♥   ♠

 ──────────────────────────────────────────────────────────────────────────────
