macOS

macOS Installation Guide

Get the Automatic Poker Odds Calculator running on your Mac in minutes. This terminal-based application automatically detects cards from your poker client and displays real-time hand probabilities.

View on GitHub

Real-time Analysis

Automatic card detection every second

Terminal UI

Beautiful ASCII card display

Win Probabilities

See your odds to win, tie, or lose

Prerequisites

Python 3.10 or higher

Check your Python version:

Terminal
python3 --version

If you don't have Python 3.10+, install it via Homebrew:

Terminal
brew install python@3.12

No additional tools needed! macOS uses native Quartz APIs for window capture, so no extra dependencies are required.

Installation

1 Clone the Repository
Terminal
git clone https://github.com/aipokertools/AutomaticPokerOddsCalculator.git cd AutomaticPokerOddsCalculator
2 Create Virtual Environment
Terminal
python3 -m venv .venv source .venv/bin/activate
3 Install Dependencies
Terminal
pip install -r requirements_macos.txt
4 Verify Installation
Terminal
python calculator.py --help

You should see:

usage: calculator.py [-h] Poker Probability Calculator options: -h, --help show this help message and exit

Usage

Start the Calculator
Terminal
source .venv/bin/activate python calculator.py

This will:

  • List all open windows
  • Let you select your poker client
  • Start the live probability display

Controls: Use ↑ / ↓ arrows to adjust opponent count (1-9). Press Ctrl+C to exit.

Display Preview

╭────────────────── Automatic Poker Odds Calculator ♥ ♦ ♣ ♠ ───────────────╮
│ Window: PokerStars  │  Opponents (↑↓): 2  │  Scan #42  │  Ctrl+C exit    │
╰──────────────────────────────────────────────────────────────────────────╯
╭─────── Your Hole Cards ───────╮╭──────────── Community Cards ────────────╮
│ ┌─────┐ ┌─────┐               ││ ┌─────┐ ┌─────┐ ┌─────┐ ┌─────┐         │
│ │J    │ │2    │               ││ │9    │ │5    │ │K    │ │7    │         │
│ │  ♦  │ │  ♣  │               ││ │  ♠  │ │  ♦  │ │  ♣  │ │  ♦  │         │
│ │    J│ │    2│               ││ │    9│ │    5│ │    K│ │    7│         │
│ └─────┘ └─────┘               ││ └─────┘ └─────┘ └─────┘ └─────┘         │
╰───────────────────────────────╯╰─────────────────────────────────────────╯
╭────────────────────────── Hand Probabilities ────────────────────────────╮
│ Hand               You                          Opp                      │
│ Straight Flush    0.0%  ░░░░░░░░░░░░░░░░░░     0.0%  ░░░░░░░░░░░░░░░░░░  │
│ Four of a Kind    0.0%  ░░░░░░░░░░░░░░░░░░     0.1%  ░░░░░░░░░░░░░░░░░░  │
│ Full House        0.0%  ░░░░░░░░░░░░░░░░░░     2.5%  ░░░░░░░░░░░░░░░░░░  │
│ Flush             0.0%  ░░░░░░░░░░░░░░░░░░     3.2%  ░░░░░░░░░░░░░░░░░░  │
│ Straight          0.0%  ░░░░░░░░░░░░░░░░░░     9.9%  ▓░░░░░░░░░░░░░░░░░  │
│ One Pair         39.0%  ▓▓▓▓▓▓▓░░░░░░░░░░░    47.9%  ▓▓▓▓▓▓▓▓░░░░░░░░░░  │
│ High Card        60.9%  ▓▓▓▓▓▓▓▓▓▓▓░░░░░░░     5.8%  ▓░░░░░░░░░░░░░░░░░  │
╰──────────────────────────────────────────────────────────────────────────╯
╭─────────────────────────── Win Probability ──────────────────────────────╮
│ ██████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ │
│   WIN:   6%   TIE:   2%   LOSE:  92%                                     │
╰──────────────────────────────────────────────────────────────────────────╯

Troubleshooting

"No visible windows found!"

Ensure your poker client is open and not minimized. The window must be visible on screen.

"Failed to capture window"

The window may have moved off-screen or been minimized. Try selecting a different window to verify capture works. You may also need to grant Screen Recording permission in System Preferences > Privacy & Security.

"API request timed out"

Check your internet connection. The API server may be temporarily unavailable.

Display looks garbled

Make sure your terminal supports Unicode and 256 colors. Recommended: iTerm2 or the built-in Terminal app. Try resizing your terminal to be wider.

API Information

Endpoint: https://aipokertools.com/api/v1/detect-cards

Rate: 1 request per second

License Key: Prompted at first run and saved to calculator_license_key.txt

You're all set! Open your poker client and start the calculator to see real-time odds.