https://github.com/skifli/snek

It's snake. But snek. And in Python.
https://github.com/skifli/snek

game python python3 retro retro-game retro-game-snake retro-games retrogaming snake snake-game snakegame

Last synced: 5 months ago
JSON representation

It's snake. But snek. And in Python.

• Host: GitHub
• URL: https://github.com/skifli/snek
• Owner: skifli
• License: mit
• Created: 2023-04-23T10:35:28.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2025-03-08T14:59:23.000Z (7 months ago)
• Last Synced: 2025-03-31T09:02:37.298Z (7 months ago)
• Topics: game, python, python3, retro, retro-game, retro-game-snake, retro-games, retrogaming, snake, snake-game, snakegame
• Language: Python
• Homepage:
• Size: 79.1 KB
• Stars: 4
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# snek

![Lines of Code](https://img.shields.io/github/languages/code-size/skifli/snek)

- [snek](#snek)

  - [Installation](#installation)

    - [Running from source](#running-from-source)

  - [Usage](#usage)

  - [Known Bugs](#known-bugs)

![Image of the game's menu](assets/menu.png)

![Image of playing the game in default mode](assets/game-pride-off.png)

![Image of playing the game with pride mode on](assets/game-pride-on.png)

It's snake. But *snek*. In **Python**. It supports all OSes that Python can run on, and was designed to look like a retro game from the early 80s. It runs entirely in your terminal, no GUI libraries required, and uses minimal external dependencies (just `colorama`).

The world width and height is automatically set to the maximum it can be for the size of terminal it is running in, and supports recalibrating when the terminal is resized. Currently the only ways to die are by hitting the world borders, or hitting the snake's body, in which case the score (but not high score), will reset.

## Installation

> [!NOTE]\

> Please make sure you have support for Unicode fonts enabled in your system's settings. If you don't, the game will not look as it should.

### Running from source

* Make sure you have [Python](https://python.org) installed and is in your system environment variables as **`python`**. If you do not have Python installed, you can install it from [here](https://python.org/download/).

* Download and extract the repository from [here](https://github.com/skifli/snek/archive/refs/heads/master.zip). Alternatively, you can clone the repository with [Git](https://git-scm.com/) by running `git clone https://github.com/skifli/snek` in a terminal.

* Navigate into the root directory of your clone of this repository.

* Run the command `python -m pip install -r requirements.txt`.

## Usage

* Run the command `python snek.py` in the root of your clone of this repository.

## Known Bugs

Please see [**`bugs.md`**](bugs.md).