pympostor

CLI impostor game with AI - A word deduction game where players must identify the impostor among them.

Description

"Adivina El Impostor" (Guess the Impostor) is a word-based deduction game where participants must figure out who the impostor is among them. It's a game of strategy and deduction that requires skill to give clues without being too obvious.

Installation

Install using pip:

pip install pympostor

Or using uv:

uv pip install pympostor

Requirements

• Python 3.13 or higher
• OpenAI API key (set in your environment or .env file)

Usage

After installation, run the game with:

pympostor play

You can customize the number of players and impostors:

pympostor play --jugadores 5 --impostores 1

Options:

• --jugadores, -j: Total number of players (minimum 3)
• --impostores, -i: Number of impostors (must be less than players/2)

How It Works

• Most players receive the same secret keyword
• One or more impostors only know the category of the keyword, not the word itself
• Players take turns saying a word related to the keyword
• Players vote to eliminate who they think is the impostor
• The game continues until the impostor is found or wins

License

This project is open source and available under the MIT License.

Author

Facundo Goiriz - facundogoiriz@gmail.com