QuickGTO is a open source poker command line and Streamlit GUI tool that assists with poker decisions using Monte Carlo equity simulations. It supports a quick, textual interface and an interactive GUI, keeping a CSV history of your sessions.

• Strict mode – suggests RAISE/CHECK/FOLD based on equity.
• Bets mode – evaluates EV for folding, calling and raising and chooses the highest EV action.
• Opponent range percentage filtering.
• Equity histogram output and CSV logging.
• Streamlit GUI with card pickers, real‑time validation and Plotly histogram.

• Python 3 with pip available.
• Libraries: cython, streamlit, eval7, numpy, plotly.

1. Install Homebrew from https://brew.sh if it is not installed.
2. Run brew install python to install Python 3 and pip.

1. Use your package manager, for example on Debian/Ubuntu: sudo apt-get install python3 python3-pip.
2. Other distributions provide similar packages (python3 and python3-pip).

1. Download Python from https://www.python.org/downloads/.
2. Run the installer and ensure "Add Python to PATH" is checked.
3. Open Command Prompt and run py --version to confirm installation.

After Python and pip are available, install the required packages:

pip install cython streamlit eval7 numpy plotly

pip may be named pip3 on some systems. Use whichever is available.

Run QuickGTO interactively in a terminal:

python gto_helper.py
# or
python3 gto_helper.py

You will be prompted for:

1. Opponents – number of villains (2–9).
2. Villain range % – e.g. 0 for random hands, 20 for top 20%.
3. Hero hand – exactly two cards, spaced (Ah Ks) or concatenated (AhKs).
4. Board cards – 0, 3, 4 or 5 cards in the same format.
5. Mode – enter s for strict or b for bets.

If you choose bets mode, you will also enter:

• Current pot
• Facing bet
• Your stack
• Raise size (0.5, 1, 2 or shove)

The program prints JSON output with the recommended action, equity and histogram. Session data is appended to gto_history.csv.

Launch the GUI with:

streamlit run app.py

The web interface allows card entry via text or dropdown pickers and shows the same results with a Plotly equity distribution graph. The sidebar contains form controls and a theme configuration hint. A CSV download button appears after a simulation.

• Strict – uses preset thresholds. RAISE if equity ≥ 65%, CHECK if equity ≥ 40%, else FOLD.
• Bets – calculates EV for folding, calling and raising using your pot and stack sizes. The action with the highest EV is recommended and EV values are displayed.

Both modes log results to gto_history.csv for later review.