python-projects

Python Projects by Muhammad Rayan Asim

Website CI Python 3.10+ License Repo Size Last Commit Views


A modular collection of Python applications, desktop utilities, algorithms, and computer vision experiments — organised by category for easy exploration and learning.


Table of Contents


Repository Structure

python-projects/
├── Calculator/        # Math algorithms and calculators
├── GUI/               # Tkinter and PyQt5 desktop apps
├── Game/              # Terminal and GUI games
├── machine_learning/  # Computer vision and ML experiments
├── Utilities/         # Practical tools and automation scripts
├── tests/             # pytest test suite
└── api/               # FastAPI backend (Vercel deployment)

Categories

Category Link README
GUI View GUI/README.md
Calculator View Calculator/README.md
Games View Game/README.md
Machine Learning View machine_learning/README.md
Utilities View Utilities/README.md

Projects

GUI

Calculator

Games

Machine Learning

Utilities


Skill Level Tags

Tag Description
Beginner Suitable for those new to Python
Intermediate Requires moderate Python knowledge
Advanced Involves advanced concepts and techniques

Installation

Prerequisites: Python 3.10 or newer. It is strongly recommended to use a virtual environment.

git clone https://github.com/mrayanasim09/python-projects.git
cd python-projects
python -m venv .venv
source .venv/bin/activate        # On Windows: .venv\Scripts\activate
pip install -e ".[dev]"          # Dev tools only (pytest, ruff, mypy)

Install extras for the category you want to run:

pip install -e ".[gui]"          # GUI apps (PyQt5, Pillow, …)
pip install -e ".[games]"        # Games (pygame)
pip install -e ".[ml]"           # Machine learning (OpenCV, mediapipe, …)
pip install -e ".[automation]"   # Desktop automation (pyautogui)
pip install -e ".[gui,ml,dev]"   # Multiple extras at once

For detailed usage instructions, see How to Use.

If you encounter any issues, please report an issue.


Running Tests

pip install -e ".[dev]"
pytest tests/ -v --cov=.

About the Author

MRayan Asim maintains this repository as a dedicated Python enthusiast focused on developing practical and innovative projects for all skill levels.

Connect with me:

Email LinkedIn GitHub

For a programming learning roadmap, read my guide on Medium.


License

This project is licensed under the MIT License for educational purposes only.


Additional Resources


Frequently Asked Questions

For common questions and troubleshooting, see the FAQ.