Skip to content

roshhellwett/projectnumsuko

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

26 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Repo Size Stars Forks Issues PyPI

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!

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

About

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

Topics

Resources

License

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages