A minimalist snake game written in Python using asyncio. Customize speed, grid size, controls, and even add a poison mode for extra challenge!

• userAnonymous
• GitHub: ramimK0bir

Install the game easily using pip:

pip install python-snake-game

pip install git+https://github.com/ramimK0bir/python-snake-game@v1.0.10

You can import and run the game from Python code:

import python_snake_game as snake_game
snake_game.play()

The game allows full key customization via three built-in functions:

1. automatic_configure_custom_key() Interactively prompts the user at runtime to configure custom keys for movement and pause.

2. manual_configure_custom_key() Allows the user to edit a configuration file to set preferred keys and save them for future sessions.

3. reset_key_configuration() Restores default key bindings, undoing any previous customizations.

import python_snake_game as snake_game
# Automatic interactive key configuration
snake_game.automatic_configure_custom_key()
# Manual configuration via config file
snake_game.manual_configure_custom_key()
# Reset keys to default
snake_game.reset_key_configuration()
# Start the game after customizing keys
snake_game.play(speed=10, grid_size=(20, 15), poison_mode=False)

Run the snake game directly from the command line:

python -m python_snake_game [options]

# Run with default settings
python -m python_snake_game
# Custom speed and grid size
python -m python_snake_game --speed 5 --grid_size 20,15
# Enable invisible walls (screen wrapping)
python -m python_snake_game --invisible_wall
# Enable poison mode
python -m python_snake_game --poison_mode
# Customize keys interactively before start game
python -m python_snake_game --customize_key
# All options together
python -m python_snake_game --speed 8 --grid_size 30,20 --invisible_wall --poison_mode --customize_key

• Arrow keys (default) to move the snake:

  • Up: w
  • Down: s
  • Left: a
  • Right: d

• Space bar to pause/resume the game.

• Custom keys can be configured via CLI or the three customization functions.

• The snake moves continuously on the grid.
• Eat the food (🍎) to grow longer and increase your score.
• Avoid hitting walls or your own body unless invisible_wall=True.
• In poison mode, some food can kill the snake instantly.
• Current score is displayed above the grid.

• Custom Key Configuration

  • Automatic – interactively configure keys via automatic_configure_custom_key().
  • Manual – configure keys by editing a configuration file via manual_configure_custom_key().
  • Reset – restore default key bindings using reset_key_configuration().

• New CLI Argument: --customize_key to trigger key customization before playing.

• Uses ANSI escape codes for terminal control (screen clear, colors).
• Works best on terminals supporting Unicode and ANSI colors.

This project is open source. Feel free to contribute or modify!