Skip to content

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

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages