https://github.com/roshhellwett/projectnumsuko

ɪɴᴛᴇʀᴀᴄᴛɪᴠᴇ ɴᴜᴍʙᴇʀ ɢᴜᴇꜱꜱɪɴɢ ɢᴀᴍᴇ
https://github.com/roshhellwett/projectnumsuko

projectnumsuko zenithopensourceprojects

Last synced: 15 days ago
JSON representation

ɪɴᴛᴇʀᴀᴄᴛɪᴠᴇ ɴᴜᴍʙᴇʀ ɢᴜᴇꜱꜱɪɴɢ ɢᴀᴍᴇ

• Host: GitHub
• URL: https://github.com/roshhellwett/projectnumsuko
• Owner: roshhellwett
• License: mit
• Created: 2025-10-05T07:04:25.000Z (9 months ago)
• Default Branch: main
• Last Pushed: 2026-04-20T17:13:02.000Z (2 months ago)
• Last Synced: 2026-05-30T10:23:34.713Z (27 days ago)
• Topics: projectnumsuko, zenithopensourceprojects
• Language: Python
• Homepage: https://zenithopensourceprojects.vercel.app
• Size: 129 KB
• Stars: 1
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: readme.md
  • License: LICENSE
  • Security: security.md

Awesome Lists containing this project

README

          
![Repo Size](https://img.shields.io/github/repo-size/roshhellwett/projectnumsuko?style=for-the-badge)

![Stars](https://img.shields.io/github/stars/roshhellwett/projectnumsuko?style=for-the-badge)

![Forks](https://img.shields.io/github/forks/roshhellwett/projectnumsuko?style=for-the-badge)

![Issues](https://img.shields.io/github/issues/roshhellwett/projectnumsuko?style=for-the-badge)

![PyPI](https://img.shields.io/pypi/v/projectnumsuko?style=for-the-badge)

# PROJECT NUMSUKO

Numsuko is a highly interactive, animated, GenZ-friendly command-line number guessing game written in Python. It challenges users to guess a randomly-generated number within a strict limit of attempts, offering a vibrant and engaging experience natively within the terminal.

---

### 🎮 Gameplay Mechanics

* **Dynamic Difficulty Levels:** Choose your challenge: Easy (1-10, 5 chances), Medium (1-20, 10 chances), or Hard (1-100, 10 chances).

* **Randomized Generation:** Implements RNG for a unique, unpredictable experience every session.

* **Interactive Feedback:** Provides real-time "Too High" or "Too Low" hints, along with "BURNING HOT" / "FREEZING" proximity tracking.

* **Infinite Replayability:** Continuous game loop allowing players to instantly replay or change difficulty seamlessly.

* **Progress Tracking:** Tracks total score, win/loss stats, win rate, and streaking across your game session!

## 🛠️ Installation

You can install `projectnumsuko` directly via PIP globally!

```bash

pip install projectnumsuko

```

## 🚀 How to Play

Once installed, simply run the name of the executable from any terminal to launch the game:

```bash

projectnumsuko

```

---

© 2026 [Zenith Open Source Projects](https://zenithopensourceprojects.vercel.app/). All Rights Reserved.Zenith is an Open Source Project Idea by Developer: @roshhellwett