retro-snake-game

Retro snake game with 8-bit charm

Demo

Watch a quick preview below (GIF)

🔹 Preview (GIF)

Features

• Classic Snake Gameplay: Navigate your growing snake to collect apples while avoiding walls and self-collision
• Retro 8-bit Graphics: Animated pixel art sprites for snake segments, apples, and authentic retro aesthetic
• Sound Effects: Nostalgic coin collection sounds, game start jingles, and background music
• High Score Tracking: Persistent local high score saves to challenge your best performance
• Smooth Controls: Responsive arrow key controls with intelligent direction handling
• Dynamic Difficulty: Snake size increases as you grow, making the game progressively challenging

Installation

Prerequisites

• Python 3.7 or higher

Install from PyPI

pip install retro-snake-game

Or:

# Install UV if you haven't already
curl -LsSf https://astral.sh/uv/install.sh | sh

# Install retro-snake-game
uv pip install retro-snake-game

Run the application

retro-snake

Or:

python -m retro_snake_game

Install from source

1. Clone the repository

   git clone https://github.com/adrirubio/retro-snake-game.git
   cd retro-snake-game
   

2. Install the package

   pip install .
   

3. Run the application

   retro-snake
   

   Or:

   python -m retro_snake_game