A modular collection of Python applications, desktop utilities, algorithms, and computer vision experiments — organised by category for easy exploration and learning.
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)
| 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 |
| Tic Tac Toe (GUI) | Terminal |
| Tag | Description |
|---|---|
| Beginner | Suitable for those new to Python |
| Intermediate | Requires moderate Python knowledge |
| Advanced | Involves advanced concepts and techniques |
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.
pip install -e ".[dev]"
pytest tests/ -v --cov=.
MRayan Asim maintains this repository as a dedicated Python enthusiast focused on developing practical and innovative projects for all skill levels.
Connect with me:
For a programming learning roadmap, read my guide on Medium.
This project is licensed under the MIT License for educational purposes only.
For common questions and troubleshooting, see the FAQ.