A Console-Based Quiz Application with an Interactive UI
Quizzard is a Python-based console quiz app designed with a polished interface. It allows users to register, log in, play timed quizzes, view their stats, and track progress through achievements and leaderboards.
The app is lightweight, fully text-based, and built for both fun and learning.
- 🔐 User Authentication (Register & Login system)
- 📜 Interactive Dashboard with a clean UI
- 📝 10 Randomized Questions per quiz attempt
- ⏳ Built-in Timer for each quiz
- 🏆 Leaderboard with ranks and scores
- 📊 Player Profile showing quiz history and achievements
- 🎖 Achievements System to encourage progress
- 💾 Persistent Data Storage (users, scores, achievements)
git clone https://github.com/0xroot-suraj/Quizzard.git
cd QuizzardCreate a virtual environment to keep your project dependencies isolated:
python -m venv venv- Windows (PowerShell):
venv\Scripts\activate
- Linux / macOS:
source venv/bin/activate
To exit the virtual environment:
deactivate💡 Once activated, any
pip install ...command will install packages only inside this environment.
pip install -r requirements.txtpython main.py- Requires Python 3.8+
- Works on Windows, Linux, and Mac
- Terminal must support Unicode for emojis/icons
Quizzard/
│── auth/ # Authentication (login, signup, logout)
│── features/ # Core quiz features
│── quiz_data/ # Quiz questions and data
│── utils/ # Helper functions
│── .gitignore # Python ignores
│── LICENSE # MIT License
├── README.md # You're reading it!
│── main.py # Entry point
└── requirements.txt # DependenciesThis project is licensed under the MIT License.
Developed with ❤️ by Shakti Suraj (@0xroot-suraj)
Contributions, suggestions, and feedback are welcome! Open an issue or submit a pull request to help improve Quizzard.