An interactive number guessing game built with Python & Streamlit, featuring difficulty levels, smart hints, animations, and a scoring system.
🔹 Beginner-friendly 🔹 Hackathon-ready 🔹 Clean UI + Logic
A fun web-based guessing game where logic meets UI. Guess the number, win the race, and score points!
🚀 About the Project
Guess The Number – Car Race Edition is a Streamlit-powered web game that challenges users to guess a randomly generated number within a limited number of attempts.
Players can choose from Easy, Medium, or Hard difficulty levels. Each level adjusts the number range and allowed attempts. When the player wins, a car race animation is triggered along with a performance-based score.
This project upgrades a classic CLI game into a modern, interactive web application and was built as part of a hackathon learning experience.
✨ Features
✅ Difficulty Levels (Easy / Medium / Hard) ✅ Random number generation ✅ Attempt limit per level ✅ Instant feedback (Higher / Lower hints) ✅ Car race progress animation ✅ Score calculation system ✅ Game restart option ✅ Smooth UI using Streamlit
🧠 How It Works
Select a difficulty level
A random number is generated internally
Enter your guess using the UI
Receive hints after each attempt
Win the game or run out of tries
On winning → animation + score 🎉
🛠️ Tech Stack Technology Usage Python Core logic Streamlit Web UI random Number generation time Animation timing ⚙️ Installation & Run Locally
git clone https://github.com/your-username/guess-the-number-streamlit.git
cd guess-the-number-streamlit
pip install streamlit
streamlit run streamlit-UI.py
🎯 Learning Outcomes
Building interactive web apps with Streamlit
Managing game state using session_state
Writing clean and readable Python logic
Enhancing user experience with animations
Turning simple ideas into presentable projects
🏆 Hackathon Submission
🧊 This project was developed and submitted during the Winter 5.0 Hackathon, focusing on creativity, usability, and clean implementation.
🔮 Future Enhancements
🏅 Leaderboard system
🔊 Sound effects
🌙 Dark mode
📱 Mobile-friendly layout
👤 Author
Yash Brahmankar 🎓 B.Tech Student 🐍 Python | Streamlit | Beginner Web Apps
📄 License
This project is licensed under the MIT License. You are free to use, modify, and distribute it.
⭐ If you like this project, consider giving it a star on GitHub!