Offline Play
Play completely offline against GnuGo AI. No internet connection or account required.
Play Go in Your Terminal
A beautiful terminal-based Go (Baduk/Weiqi) client with offline AI opponent
Features
Custom Board Color
Personalize your game with customizable board colors to match your terminal aesthetic.
Configurable
Board sizes (9x9, 13x13, 19x19), 10 difficulty levels, adjustable komi, play as Black or White.
Cross-Platform
Works on macOS, Linux, and Windows. Built with Go for easy installation.
No Time Limits
Take your time to think. Untimed games allow for thoughtful, strategic play.
Open Source
Free and open source. Contribute, modify, and learn from the code.
SGF Game Saving
Games are automatically saved in SGF format — the universal standard for Go game records.
Game History
Browse your past games and pick up where you left off. Your full move history is preserved.
Undo Moves
Made a mistake? Press U to undo your last move and try a different line.
Installation
Quick Install
One-liner (macOS/Linux)
curl -fsSL https://raw.githubusercontent.com/JollyGrin/termsuji-local/master/install.sh | bashPrerequisites
You need GnuGo installed on your system:
macOS (Homebrew)
brew install gnu-go
Ubuntu/Debian
sudo apt install gnugo
Arch Linux
sudo pacman -S gnugoInstall termsuji-local
Using Go
go install github.com/jollygrin/termsuji-local@latestOr clone and build from source:
From Source
git clone https://github.com/jollygrin/termsuji-local.git
cd termsuji-local
go build -o termsuji-local .Usage
Start a game
termsuji-localControls
| Key | Action |
|---|---|
| Arrow Keys | Move cursor on board |
| Enter | Place stone at cursor position |
| P | Pass your turn |
| Q | Quit the game |
| U | Undo last move |
| R | Toggle game recording |
Game Setup Options
- Board Size: 9x9 (quick games), 13x13 (medium), 19x19 (full)
- Your Color: Black (plays first) or White (plays second)
- Difficulty: 1 (easiest) to 10 (hardest)
- Komi: Compensation points for White (typically 6.5 or 7.5)
What is Go?
Go (also known as Baduk in Korean and Weiqi in Chinese) is an ancient strategy board game that originated in China over 2,500 years ago. Two players take turns placing black and white stones on a grid, aiming to surround more territory than their opponent.
Despite simple rules, Go has extraordinary strategic depth. The number of possible game positions exceeds the number of atoms in the observable universe, making it one of the most complex games ever created.
Go was the last classic board game where AI could not defeat top human players, until AlphaGo's historic victory in 2016. Today, AI Go engines have become invaluable training tools for players of all levels.
FAQ
What is GnuGo?
GnuGo is a free, open-source Go-playing program developed by the GNU Project. It provides a reliable AI opponent for practice and uses the GTP (Go Text Protocol) to communicate with interfaces like termsuji-local.
How strong is the AI?
GnuGo plays at approximately 5-8 kyu level (intermediate amateur). It's excellent for beginners and intermediate players. For stronger AI opponents, consider using KataGo with a GTP-compatible interface.
Can I play online against other humans?
termsuji-local is designed for offline play against AI. For online play against humans, check out the original termsuji project which connects to online-go.com.
What terminal should I use?
Any modern terminal works: Terminal.app (macOS), iTerm2, Windows Terminal, GNOME Terminal, Konsole, Alacritty, Kitty, etc. For the best experience, use a terminal that supports Unicode and 256 colors.
Feedback
Found a bug or have a feature in mind? Open a ticket on GitHub — your input shapes the project.