From 91cfd64df160c4da06e76c751adef78ef6dc7f4a Mon Sep 17 00:00:00 2001 From: Aaqibhafeez Khan Date: Thu, 17 Sep 2026 18:23:19 +0530 Subject: [PATCH] docs: update project README for issue #331 --- README.md | 105 +++++++++++++++++++++++++++--------------------------- 1 file changed, 53 insertions(+), 52 deletions(-) diff --git a/README.md b/README.md index e86d05e7..a023f895 100644 --- a/README.md +++ b/README.md @@ -1,79 +1,80 @@ +# Python Projects 🐍 -# Python Projects python -A Hub of Python Projects for Beginners. - - - +A beginner-friendly collection of Python projects covering games, automation, desktop applications, networking, computer vision, machine learning, and utilities. ## Description -Welcome aboard fellow developer, this repository is intended for beginners who can use it for project building, open source contribution and get the most from it. -If you are new to open source then do consider this repository to start with. - -There are various projects under this repository which will be helpful for you get familiar with Python programming. - +This repository is intended for beginners who want to practice Python, build small projects, explore different libraries, and make open-source contributions. +The project list below reflects the current directories in the repository. Each entry includes a short description and links directly to the corresponding project directory. ## Projects -This repository has the following Projects. -### Basic Projects along with *Miscellaneous Games* like- -- [Tic-Tac-Toe](https://github.com/Shahrayar123/Python-Projects/tree/master/Tic-Tac-Toe) -- [Towers of Hanoi](https://github.com/Shahrayar123/Python-Projects/tree/master/Towers%20of%20Hanoi) -- [Hangman game](https://github.com/Shahrayar123/Python-Projects/tree/master/Hangman%20Game) -- [Turtle crossing Capstone Game](https://github.com/Shahrayar123/Python-Projects/tree/master/Turtle%20Crossing%20Capstone%20Game) -- [SNAKE](https://github.com/Shahrayar123/Python-Projects/tree/master/SNAKE) -- [Number Guessing Game](https://github.com/Shahrayar123/Python-Projects/tree/master/Number%20Guessing%20Game) -- [Rock Paper Scissors Game](https://github.com/Shahrayar123/Python-Projects/tree/master/Rock%20Paper%20Scissors%20Game) -- [Sudoku-Solver](https://github.com/Shahrayar123/Python-Projects/tree/master/Sudoku-Solver) - -### OpenCV projects. - -- [AI_Attendence_Program](https://github.com/Shahrayar123/Python-Projects/tree/master/AI_Attendence_Program) -- [FaceRecognition](https://github.com/Shahrayar123/Python-Projects/tree/master/FaceRecgonition) -- [QR Code generator](https://github.com/Shahrayar123/Python-Projects/tree/master/QR%20Code) - -### Other projects (not yet validated). -- [AirCanvas](https://github.com/Shahrayar123/Python-Projects/tree/master/AirCanvas) -- [Conway's Game of Life](https://github.com/Shahrayar123/Python-Projects/tree/master/Conway's%20Game%20of%20Life) -- [Dice-Simulator](https://github.com/Shahrayar123/Python-Projects/tree/master/Dice-Simulator) -- [Dictionary-App](https://github.com/Shahrayar123/Python-Projects/tree/master/Dictionary-App) -- [Riddle](https://github.com/Shahrayar123/Python-Projects/tree/master/Riddle) -- [SchduledMessageWhatsApp](https://github.com/Shahrayar123/Python-Projects/tree/master/SchduledMessageWhatsApp) -- [Screen_Recording_App](https://github.com/Shahrayar123/Python-Projects/tree/master/Screen_Recording_App) -- [Student Management System](https://github.com/Shahrayar123/Python-Projects/tree/master/Student%20Management%20System) -- [Web_Automation](https://github.com/Shahrayar123/Python-Projects/tree/master/Web_Automation) -- [Youtube Searching Script](https://github.com/Shahrayar123/Python-Projects/tree/master/Youtube%20Searching%20Script) -- [pokemone_battle](https://github.com/Shahrayar123/Python-Projects/tree/master/pokemone_battle.py) -- [Text-to-Speech](https://github.com/Shahrayar123/Python-Projects/tree/master/Text-to-Speech) +### Games and Puzzles +- [Tic-Tac-Toe](https://github.com/Shahrayar123/Python-Projects/tree/master/Tic-Tac-Toe) β€” A classic two-player Tic-Tac-Toe game implemented in Python. +- [Towers of Hanoi](https://github.com/Shahrayar123/Python-Projects/tree/master/Towers%20of%20Hanoi) β€” A recursive implementation of the Towers of Hanoi puzzle. +- [Hangman Game](https://github.com/Shahrayar123/Python-Projects/tree/master/Hangman%20Game) β€” A word-guessing Hangman game. +- [Turtle Crossing Capstone Game](https://github.com/Shahrayar123/Python-Projects/tree/master/Turtle%20Crossing%20Capstone%20Game) β€” A Turtle-based crossing game where the player avoids moving obstacles. +- [SNAKE](https://github.com/Shahrayar123/Python-Projects/tree/master/SNAKE) β€” A classic Snake game built with Python. +- [Number Guessing Game](https://github.com/Shahrayar123/Python-Projects/tree/master/Number%20Guessing%20Game) β€” A number guessing game with input handling and difficulty options. +- [Rock Paper Scissors Game](https://github.com/Shahrayar123/Python-Projects/tree/master/Rock%20Paper%20Scissors%20Game) β€” A command-line Rock Paper Scissors game. +- [Sudoku-Solver](https://github.com/Shahrayar123/Python-Projects/tree/master/Sudoku-Solver) β€” A program for solving Sudoku puzzles. +- [Dice-Simulator](https://github.com/Shahrayar123/Python-Projects/tree/master/Dice-Simulator) β€” Simulates dice rolls using Python's random functionality. +- [Riddle](https://github.com/Shahrayar123/Python-Projects/tree/master/Riddle) β€” A simple riddle-based Python project. +- [Car Racing Game](https://github.com/Shahrayar123/Python-Projects/tree/master/Car%20Racing%20Game) β€” A Pygame racing game with player movement and obstacles. +- [pokemone_battle](https://github.com/Shahrayar123/Python-Projects/tree/master/pokemone_battle.py) β€” A Python-based PokΓ©mon battle project. -## Contribution +### Computer Vision and Image Processing -Contributions are always welcome! +- [AI_Attendence_Program](https://github.com/Shahrayar123/Python-Projects/tree/master/AI_Attendence_Program) β€” A face-recognition-based attendance program that records recognized attendees. +- [FaceRecognition](https://github.com/Shahrayar123/Python-Projects/tree/master/FaceRecgonition) β€” A computer vision project for recognizing faces. +- [QR Code](https://github.com/Shahrayar123/Python-Projects/tree/master/QR%20Code) β€” A Python project for generating QR codes. +- [AirCanvas](https://github.com/Shahrayar123/Python-Projects/tree/master/AirCanvas) β€” An interactive drawing project that uses computer vision to draw in the air. +- [Pictures Organizer](https://github.com/Shahrayar123/Python-Projects/tree/master/Pictures%20Organizer) β€” Organizes pictures into folders based on detected face counts using OpenCV. +### Artificial Intelligence and Machine Learning +- [Language Detector](https://github.com/Shahrayar123/Python-Projects/tree/master/Language%20Detector) β€” Detects the language of text using the `langdetect` library. +- [Sonic.ai](https://github.com/Shahrayar123/Python-Projects/tree/master/Sonic.ai) β€” A Logistic Regression classifier that distinguishes sonar signals associated with mines and rocks. +- [Whatsapp Chats Sentiment Analysis](https://github.com/Shahrayar123/Python-Projects/tree/master/Whatsapp%20Chats%20Sentiment%20Analysis) β€” An NLP project that analyzes sentiment in exported WhatsApp chats using VADER. -### Instructions -1. Fork this repository +### Desktop Applications and GUI Projects -2. Clone your forked repository +- [Banking App](https://github.com/Shahrayar123/Python-Projects/tree/master/Banking%20App) β€” A simple banking application using SQLite for storage, with card-number validation, transfers, and withdrawals. +- [Student Management System](https://github.com/Shahrayar123/Python-Projects/tree/master/Student%20Management%20System) β€” A Python application for managing student information. +- [Screen Recording App](https://github.com/Shahrayar123/Python-Projects/tree/master/Screen_Recording_App) β€” A Python application for recording the computer screen. +- [Tkinter Clock](https://github.com/Shahrayar123/Python-Projects/tree/master/Tkinter%20Clock) β€” A Tkinter desktop alarm clock that lets users set an alarm time and receive a notification. +- [Text-to-Speech](https://github.com/Shahrayar123/Python-Projects/tree/master/Text-to-Speech) β€” Converts text into spoken audio using Python. +- [Conway's Game of Life](https://github.com/Shahrayar123/Python-Projects/tree/master/Conway's%20Game%20of%20Life) β€” A graphical implementation of Conway's cellular automaton. -3. Add your scripts along with description +### Automation and Productivity -4. Commit and push +- [Dictionary-App](https://github.com/Shahrayar123/Python-Projects/tree/master/Dictionary-App) β€” A Python dictionary application for looking up word meanings. +- [SchduledMessageWhatsApp](https://github.com/Shahrayar123/Python-Projects/tree/master/SchduledMessageWhatsApp) β€” Automates scheduled WhatsApp message sending. +- [Web_Automation](https://github.com/Shahrayar123/Python-Projects/tree/master/Web_Automation) β€” Python scripts for automating web browser tasks. +- [Youtube Searching Script](https://github.com/Shahrayar123/Python-Projects/tree/master/Youtube%20Searching%20Script) β€” A script for searching YouTube from Python. +- [Local-Chat](https://github.com/Shahrayar123/Python-Projects/tree/master/Local-Chat) β€” A local-network chat application that uses a generated secret key to connect users. -5. Create a pull request +### Networking and Utilities -6. Star this repository +- [Networking-Tools](https://github.com/Shahrayar123/Python-Projects/tree/master/Networking-Tools) β€” A collection of simple Python networking tools, including utilities for network-related tasks. -7. Wait for pull request to merge +## Contribution +Contributions are always welcome! +### Instructions +1. Fork this repository. +2. Clone your forked repository. +3. Add your project or improve an existing project with a clear description. +4. Commit and push your changes. +5. Create a pull request against the `master` branch. +6. Wait for the pull request to be reviewed and merged. -#### Celebrate your first step into the open source world and contribute more. +Please keep contributions focused, beginner-friendly, and easy to understand. See [GitHub Contribution Documentation](https://docs.github.com/en/get-started/quickstart/contributing-to-projects) for more reference. - +#### Celebrate your first step into the open-source world and keep contributing! πŸš€