flop7 1.0.2

An unofficial Flip 7 terminal emulator and bot-testing sandbox

Flop 7

Welcome to Flop 7, the unofficial terminal emulator for Flip 7. You can play virtual games, keep score for live games at the table, or run batched all-bot simulations to benchmark your own strategies.

Really, this repo is made to build and test different bot strategies. See the bot guide for more info.

Install

# Homebrew (macOS / Linux)
brew tap benhalladay08/flop7
brew install flop7

# pipx
pipx install flop7

# pip
pip install flop7

# install.sh (downloads the latest release binary)
curl -fsSL https://raw.githubusercontent.com/benhalladay08/flop7/main/install.sh | sh

For full options including local development installs, see docs/install.md.

Run

flop7

Documentation

• Install — distribution channels and platform notes
• Rules — Flip 7 game rules
• Architecture — comprehensive layer-by-layer reference
• Roadmap — planned features

Guides

• Local development — clone, run, and test the repo
• Building bots — write a new bot, register it, and benchmark it
• Building trackers — collect custom statistics across simulation batches

Contributing

See CONTRIBUTING.md.

---

Created by Ben Halladay