README with game details and setup instructions

Added detailed description, features, installation instructions, controls, and project structure for the Snake game.

README.md

@@ -1 +1,41 @@
+# 🐍 Snake (Pygame Edition)
 
+A colorful, feature-rich Snake game written in **Python** using the **Pygame** library. This version elevates the classic arcade experience with modern mechanics, a progression system, and local multiplayer.
+
+## 🌟 Key Features
+
+* **Game Modes:** Play solo or go head-to-head in Duo mode with a friend.
+* **Smart AI:** Challenge yourself against an optional AI-controlled opponent for Player 2.
+* **Deep Customization:** Adjust difficulty levels, map sizes, and obstacle density to suit your playstyle.
+* **Dynamic Gameplay:** Various fruit types with unique scores/effects and customizable "bad food" behavior.
+* **Progression System:** Unlockable skins, trails, visual effects, SFX packs, and music styles to personalize your experience.
+* **Persistence:** Your high scores and settings are automatically saved and loaded via JSON and text files.
+
+## 🛠️ Installation & Setup
+
+### Requirements
+* **Python:** 3.10 or newer
+* **Pygame:** 2.6.1 or newer
+
+### Quick Start
+1. **Install dependencies:**
+   `pip install pygame`
+2. **Launch the game:**
+   `python snake.py`
+
+## 🎮 Controls
+
+| Action | Player 1 | Player 2 (Human) |
+| :--- | :--- | :--- |
+| **Movement** | `W`, `A`, `S`, `D` | Arrow Keys |
+| **Menu Navigation** | Arrows / `W`, `S` + `Enter` | — |
+| **Settings** | Mouse Click Support | — |
+
+## 📁 Project Structure
+
+* `snake.py`: The core game engine containing all logic and rendering.
+* `snake_settings.json`: Stores your personalized game configuration and progress.
+* `snake_high_score.txt`: Keeps track of your highest achieved scores.
+
+---
+*Note: Make sure audio is enabled in your system to enjoy the full experience with custom SFX and music styles. If the game window does not open, please verify your Python and Pygame installation.*