Readme.md

🐍 Python Mini Projects Collection

A collection of simple and beginner-friendly Python mini projects created to practice core Python concepts such as loops, conditionals, functions, lists, and basic user interaction.

This repository is ideal for anyone learning Python and wanting to build small, practical projects.

📁 Project Structure python-mini-projects/

📁 Project Structure

• guess_the_number/
  • guess_the_number.py
• rock_paper_scissors/
  • rock_paper_scissors.py
• number_order/
  • number_order.py
• code_generator/
  • qr_code_generator.py
• requirements.txt
• .gitignore
• README.md

Each folder contains one independent Python mini-project

Projects can be run individually

External dependencies are listed in requirements.txt

🎮 Mini Projects Included 1️⃣ Guess the Number

-The computer randomly selects a number

-The user guesses until the correct number is found

-Uses loops, conditionals, and the random module

2️⃣ Rock Paper Scissors

-Play Rock, Paper, Scissors against the computer

-Demonstrates input handling and basic game logic

3️⃣ Number Order

-Takes multiple numbers as input

-Sorts and displays them in order

-Uses lists and sorting techniques

4️⃣ QR Code Generator

-Generates a QR code from user input

-Saves the QR code as an image file

-Uses external libraries (qrcode, Pillow)

🛠️ Technologies Used

-Python 3

-Python Standard Library

-External Libraries:

--> qrcode

--> Pillow

📦 Installation & Setup 1️⃣ Clone the repository git clone cd python-mini-projects

2️⃣ Install required dependencies pip install -r requirements.txt

Or manually:

pip install qrcode pillow

These dependencies are required only for the QR Code Generator project.

▶️ How to Run a Project

Navigate into the project folder and run the Python file.

Example: python guess_the_number/guess_the_number.py

Or:

python code_generator/qr_code_generator.py

Each project runs independently.

🎯 Learning Objectives

-Practice Python basics

-Improve logical thinking

-Learn how to structure Python projects

-Work with external Python libraries

-Build confidence by creating working programs

🚀 Future Improvements

-Add a menu-based launcher (main.py)

-Improve input validation

-Add score tracking

-Add GUI versions using Tkinter

-Add more mini-projects

-Write tests for projects

🤝 Contributing

This project is built for learning purposes. Suggestions and improvements are welcome — feel free to fork and experiment.

📜 License

This project is open-source and free to use for educational purposes.

⭐ If you find this helpful, consider giving the repository a star!