GSSoC Approved Repository
๐ Perfect for beginners | ๐ก Learn by doing | ๐จ Beautiful UI | โก Zero setup required
Quick Start โข Contributing โข Contributors โข Features
Tired of boring "Hello World" tutorials?
We built this collection to make learning Python fun, interactive, and instantly rewarding! Each project is:
- โ Complete & Ready to Run - No setup, no dependencies, just pure Python fun
- ๐จ Visually Stunning - Beautiful emoji-based UI that makes coding exciting
- ๐ Educational - Learn core concepts while building real projects
- ๐ฎ Engaging - From games to tools, there's something for everyone
- ๐ช Beginner-Friendly - Clean code with no complex functions
Perfect for: Students learning Python, teachers looking for class projects, or anyone wanting to code something fun in minutes!
Experience all 24 projects in your browser with beautiful animations and visualizations!
# Clone the repository
git clone https://github.com/steam-bell-92/python-mini-project.git
# Navigate to the web app
cd python-mini-project/web-app
# Start the web server
python -m http.server 8000
# Open http://localhost:8000 in your browser# Navigate to the project
cd python-mini-project
# Run any project (no installation needed!)
python games/Rock-Paper-Scissor/Rock-Paper-Scissor.pyThat's it! No pip installs, no virtual environments, just instant fun! ๐
- All Projects in Your Browser - No Python installation required!
- Beautiful Animations - Smooth transitions and visual effects
- Dark/Light Theme - Toggle between themes for comfort
- Category Filtering - Browse by Games, Math, or Utilities
- Responsive Design - Works on desktop, tablet, and mobile
- Zero Setup - Just open and play!
| Feature | Description |
|---|---|
| Beautiful UI | Every project uses emojis for an engaging visual experience |
| Zero Dependencies | Pure Python - no external packages required! |
| Well-Documented | Clear code with helpful comments throughout |
| Beginner-Friendly | Perfect for Python learners at any level |
| Instant Run | No setup required - just download and play! |
| Interactive | All projects feature user interaction and feedback |
-
Clone the repository
git clone https://github.com/steam-bell-92/python-mini-project.git cd python-mini-project/web-app -
Start a local server
# Using Python 3 python -m http.server 8000 # Or using Node.js npx http-server
-
Open your browser and visit
http://localhost:8000 -
Enjoy all projects with beautiful animations! ๐
- Python 3.10 or higher (Download here)
- Any text editor or IDE (VS Code, PyCharm, or even Notepad!)
- Choose a project from the list above
- Open your terminal/command prompt
- Navigate to the project folder
- Run the Python file:
python games/Rock-Paper-Scissor/Rock-Paper-Scissor.py
- Have fun! ๐
- ๐ก Try the web app first for an instant, visual experience
- ๐ฎ Start with simple games like Coin Flip or Dice Rolling
- ๐ Read through the code to understand how it works
- ๐จ Try modifying emojis or messages to personalize the projects
- ๐ง Experiment with changing game rules or adding features
- ๐ค Share your improvements with the community!
We love contributions! Here's how you can help:
- ๐ด Fork the repository
- ๐ Create a new branch (
git checkout -b feature/AmazingProject) - ๐ป Add your mini project
- Python CLI version in a category folder (
games/,math/, orutilities/) and then its own project folder (for examplegames/Project-Name/Project-Name.py) - Web implementation in
web-app/js/projects.js
- Python CLI version in a category folder (
- โ Ensure it follows our style (emojis, clean code)
- ๐ค Commit your changes (
git commit -m 'Add Amazing Project') - ๐ Push to the branch (
git push origin feature/AmazingProject) - ๐ Open a Pull Request
See CONTRIBUTING.md for detailed guidelines.
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n This project is licensed under the MIT License - see the LICENSE file for details.
Found this helpful? Show some love!
- โญ Star this repo if you found it useful
- ๐ Report bugs or suggest features via Issues
- ๐ฌ Share with friends learning Python
- ๐ Use in your classroom or coding club
Made with โค๏ธ for Python learners everywhere
If you learned something new, don't forget to star the repo! โญ
-
Papia-tech
-
PIYUSH-NEXTGEN
-
Avneesh95
-
tanishkakora
-
anujsharma8d
-
MoonLawlier
-
Lavanya-Talele
-
prasad-0007
-
developer-yash03