Metadata-Version: 2.4
Name: projectnumsuko
Version: 1.0.1
Summary: A GenZ-friendly interactive number guessing game in the terminal.
Project-URL: Homepage, https://github.com/roshhellwett/projectnumsuko
Author: roshhellwett
License: MIT License
License-File: LICENSE
Keywords: game,genz,guessing,numbers,rich,terminal
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.8
Requires-Dist: rich
Description-Content-Type: text/markdown

![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)
![Python](https://img.shields.io/badge/Language-Python-3776AB?style=for-the-badge&logo=python)
![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.

---

## ✨ Key Features

### 🎮 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!

### ⚡ Core Functionality
* **GenZ-Friendly Interactive UI:** Aesthetically pleasing TUI using the `rich` library with full-color panels, markdown formatting, tables, and sleek terminal animations (e.g. running rabbits and slithering snakes).
* **Global Pip Deployment:** Easily installable and executable with a simple global command: `projectnumsuko`. No virtual environments needed!
* **Cross-Platform Compatibility:** Runs beautifully on Windows, macOS, or Linux.

## 🛠️ 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
