Terminal Poker

Play No-Limit Texas Hold'em right in your terminal — against AI opponents that actually think, with a real fetch.ai agent advising your live games.

$pip install terminalpokercopy

then just run terminalpoker

Prefer an isolated install?

$pipx install terminalpokercopy

With the fetch.ai advisor:

$pip install "terminalpoker[fetchai]"copy

Pure-Python engineZero core depsfetch.ai uAgent10/10 tests passing

Terminal Poker gameplay: rendered hole cards, the dealer button, pot, and action prompt running in a real terminal — Real gameplay — your hole cards, the dealer button, the live pot, and your move prompt, all in the terminal.

How it works

🃏

A real poker engine

Full No-Limit Hold'em: blinds, position, every betting round, all-ins, side pots and showdowns. A fast direct hand evaluator ranks 7-card hands — cross-checked against brute force on 20,000 hands with zero mismatches.

🤖

AI that thinks

Each opponent has a personality (aggressive, tight, bluffy) and decides by Monte Carlo equity simulation — dealing out thousands of random run-outs to estimate its real win probability, then weighing it against the pot odds.

🌈

Lives in your terminal

Rendered cards, the dealer button, live pot, and your current best hand — all drawn with ANSI color. One pip install puts the terminalpoker command on your PATH. No GUI, no browser, no account.

How it integrates fetch.ai

The same equity engine that powers the bots runs as a genuine fetch.ai uAgent. Start a real online game in advisor mode and every recommendation is a real request/response over the uAgents message protocol — not a local function call.

terminalpoker

your live PokerNow hand

AdviceRequest──────▶

◀──────AdviceResponse

fetch.ai uAgent

agent1q… · computes equity

You relay the hand — your cards, the board, the pot, the bet to call. Terminal Poker mirrors it on screen.
It messages the agent. The hand state is serialized into an AdviceRequest and sent to the uAgent's HTTP endpoint — exactly how two fetch.ai agents talk.
The agent answers. It runs the Monte Carlo equity engine and replies with an AdviceResponse: the +EV action, bet sizing, win-equity, and a one-line rationale.
You make the move. It's advice-only — Terminal Poker never acts on a third-party table, so it stays fair and within site rules.

terminalpoker --mode real --fetchai

  Advisor: live fetch.ai uAgent agent1qdgq2ng5tu…

  Your hand:  A♠ K♠
  Board:      A♥ 7♦ 2♣
  Pot $120   To call $40   Opponents 2

  ▶ advisor (fetch.ai agent):  RAISE to ~$214
  Win equity ~81% vs 2 opp; pot odds 25%.
  Equity supports applying pressure.
  (Make the move yourself in the real client.)

Don't take our word for it — pytest tests/test_fetchai.py boots the uAgent and round-trips advice over the protocol. ✅

Get playing in 10 seconds

1Install

$pip install terminalpokercopy

2Play vs AI

$terminalpokercopy

3Advise a real game with fetch.ai

$terminalpoker --mode real --fetchaicopy

In-game controls: f fold · k check · c call · r 60 raise · a all-in · q quit