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!

pip install projectnumsuko

🚀 How to Play

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

projectnumsuko

© 2026 Zenith Open Source Projects. All Rights Reserved.Zenith is an Open Source Project Idea by Developer: @roshhellwett