Skip to content

About

15+ fun Python project, zero dependencies, beginner-friendly code with emoji UI.

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

 
 

Repository files navigation

GSSoC Approved Repository

🎮 Python Mini Projects Collection 🎯

Learn Python by Building Fun, Interactive Games & Tools!

Python Version License

🚀 Perfect for beginners | 💡 Learn by doing | 🎨 Beautiful UI | ⚡ Zero setup required

Quick Start • Contributing • Contributors • Features


🎯 Why This Repository?

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!


⚡ Quick Start

🌐 Try the Web App (Recommended!)

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

🐍 Or Run Python Projects Directly

# Navigate to the project
cd python-mini-project

# Run any project (no installation needed!)
python games/Rock-Paper-Scissor/Rock-Paper-Scissor.py

That's it! No pip installs, no virtual environments, just instant fun! 🎉


✨ Features

🌐 Interactive Web Application

  • 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!

🐍 Python CLI Projects

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

🚀 Getting Started Guide

🌐 Web Application (Easiest Way!)

  1. Clone the repository

    git clone https://github.com/steam-bell-92/python-mini-project.git
    cd python-mini-project/web-app
  2. Start a local server

    # Using Python 3
    python -m http.server 8000
    
    # Or using Node.js
    npx http-server
  3. Open your browser and visit http://localhost:8000

  4. Enjoy all projects with beautiful animations! 🎉

🐍 Python CLI Projects

Prerequisites

  • Python 3.10 or higher (Download here)
  • Any text editor or IDE (VS Code, PyCharm, or even Notepad!)

Running Your First Project

  1. Choose a project from the list above
  2. Open your terminal/command prompt
  3. Navigate to the project folder
  4. Run the Python file:
    python games/Rock-Paper-Scissor/Rock-Paper-Scissor.py
  5. Have fun! 🎉

Tips for Beginners

  • 💡 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!

🤝 Contributing

We love contributions! Here's how you can help:

Adding New Projects

  1. 🍴 Fork the repository
  2. 🌟 Create a new branch (git checkout -b feature/AmazingProject)
  3. 💻 Add your mini project
    • Python CLI version in a category folder (games/, math/, or utilities/) and then its own project folder (for example games/Project-Name/Project-Name.py)
    • Web implementation in web-app/js/projects.js
  4. ✅ Ensure it follows our style (emojis, clean code)
  5. 📤 Commit your changes (git commit -m 'Add Amazing Project')
  6. 🚀 Push to the branch (git push origin feature/AmazingProject)
  7. 🎉 Open a Pull Request

Project Guidelines

See CONTRIBUTING.md for detailed guidelines.


Contributors

\n 01mayankk\n
@01mayankk
\n
\n AQUA1310\n
@AQUA1310
\n
\n AbhijeetMukherjee-ML\n
@AbhijeetMukherjee-ML
\n
\n Abhishek-Satyarum\n
@Abhishek-Satyarum
\n
\n Akhileswar6\n
@Akhileswar6
\n
\n Alvi24-hub\n
@Alvi24-hub
\n
\n AnushkaJagtap22\n
@AnushkaJagtap22
\n
\n Aqifcodes\n
@Aqifcodes
\n
\n Archana7224\n
@Archana7224
\n
\n Arpitawork24\n
@Arpitawork24
\n
\n ArshiBansal\n
@ArshiBansal
\n
\n Arun35-wolf\n
@Arun35-wolf
\n
\n Ashvin-KS\n
@Ashvin-KS
\n
\n Avneesh95\n
@Avneesh95
\n
\n Bhairavi-28\n
@Bhairavi-28
\n
\n Bhavikapatel06\n
@Bhavikapatel06
\n
\n DeepeshKafalatiya\n
@DeepeshKafalatiya
\n
\n Devexhhh\n
@Devexhhh
\n
\n Diksha57-git\n
@Diksha57-git
\n
\n Facelessism\n
@Facelessism
\n
\n Grihika\n
@Grihika
\n
\n HARSHP-16\n
@HARSHP-16
\n
\n Hardikdhoot121\n
@Hardikdhoot121
\n
\n HarshitaShakya\n
@HarshitaShakya
\n
\n Indrayani11-15\n
@Indrayani11-15
\n
\n Ishita-varshney\n
@Ishita-varshney
\n
\n IshitaPrajapati08\n
@IshitaPrajapati08
\n
\n Juhi4433\n
@Juhi4433
\n
\n Kartikeyji17\n
@Kartikeyji17
\n
\n KhushiVadadoriya\n
@KhushiVadadoriya
\n
\n Kinara2020\n
@Kinara2020
\n
\n Kirtan-pc\n
@Kirtan-pc
\n
\n Krasper707\n
@Krasper707
\n
\n Kunal241207\n
@Kunal241207
\n
\n KunwarSidhu47\n
@KunwarSidhu47
\n
\n Lakshayg136\n
@Lakshayg136
\n
\n Lalitya31\n
@Lalitya31
\n
\n Lavanya-Talele\n
@Lavanya-Talele
\n
\n MadhuriChowdary73\n
@MadhuriChowdary73
\n
\n Mayank251125\n
@Mayank251125
\n
\n Mohanapriya-sparks\n
@Mohanapriya-sparks
\n
\n Mohit-001-hash\n
@Mohit-001-hash
\n
\n MoonLawlier\n
@MoonLawlier
\n
\n Mounika-39\n
@Mounika-39
\n
\n Mudita-Singh\n
@Mudita-Singh
\n
\n Naveen-Boddepalli\n
@Naveen-Boddepalli
\n
\n NehaP1706\n
@NehaP1706
\n
\n Nencypatel21\n
@Nencypatel21
\n
\n Nicks-19\n
@Nicks-19
\n
\n NidhiS-7\n
@NidhiS-7
\n
\n NileshRaut2601\n
@NileshRaut2601
\n
\n PIYUSH-NEXTGEN\n
@PIYUSH-NEXTGEN
\n
\n PRODHOSH\n
@PRODHOSH
\n
\n Papia-tech\n
@Papia-tech
\n
\n ParidhiMis\n
@ParidhiMis
\n
\n Pavithra-git162\n
@Pavithra-git162
\n
\n Prachi0942\n
@Prachi0942
\n
\n PragatiNigam29\n
@PragatiNigam29
\n
\n Pratikshya32\n
@Pratikshya32
\n
\n Quantum3600\n
@Quantum3600
\n
\n RaghuveerSingh05\n
@RaghuveerSingh05
\n
\n Ranjanmaiti6\n
@Ranjanmaiti6
\n
\n Reaper-ai\n
@Reaper-ai
\n
\n Ridima28\n
@Ridima28
\n
\n SANDHIYAPRIYADHARSHINI\n
@SANDHIYAPRIYADHARSHINI
\n
\n Saloni885\n
@Saloni885
\n
\n Sanjhivvarshan-b-s\n
@Sanjhivvarshan-b-s
\n
\n Sargam-Ghagre\n
@Sargam-Ghagre
\n
\n SathvikaTalari\n
@SathvikaTalari
\n
\n Saubhagya1621\n
@Saubhagya1621
\n
\n Shashank-8p\n
@Shashank-8p
\n
\n Shital861\n
@Shital861
\n
\n Shivi-Srivastava-4444\n
@Shivi-Srivastava-4444
\n
\n Shreya-nipunge\n
@Shreya-nipunge
\n
\n ShreyaJ-27\n
@ShreyaJ-27
\n
\n Siddh2024\n
@Siddh2024
\n
\n Sparshjoshi-iit\n
@Sparshjoshi-iit
\n
\n Sreekuttan-007\n
@Sreekuttan-007
\n
\n Srushti-Thombre\n
@Srushti-Thombre
\n
\n Suhani-ai-dev\n
@Suhani-ai-dev
\n
\n Swathy-S-08\n
@Swathy-S-08
\n
\n Tech4Aditya\n
@Tech4Aditya
\n
\n TheBinaryAVA\n
@TheBinaryAVA
\n
\n Tiago-Vier-Preto\n
@Tiago-Vier-Preto
\n
\n Tomeshwari-02\n
@Tomeshwari-02
\n
\n Vaishnavisatle2105\n
@Vaishnavisatle2105
\n
\n Vanshikakhasat\n
@Vanshikakhasat
\n
\n Vinanthi07\n
@Vinanthi07
\n
\n Yogender-verma\n
@Yogender-verma
\n
\n aaniya22\n
@aaniya22
\n
\n aayuxsh326\n
@aayuxsh326
\n
\n abdullahxyz85\n
@abdullahxyz85
\n
\n abhi-nav-25\n
@abhi-nav-25
\n
\n advikdivekar\n
@advikdivekar
\n
\n akshara200829-lgtm\n
@akshara200829-lgtm
\n
\n akshaya209\n
@akshaya209
\n
\n anshul23102\n
@anshul23102
\n
\n anujsharma8d\n
@anujsharma8d
\n
\n artic2702\n
@artic2702
\n
\n ash-heinz\n
@ash-heinz
\n
\n aspartic-gthb\n
@aspartic-gthb
\n
\n avzuha\n
@avzuha
\n
\n ayushyadav0707\n
@ayushyadav0707
\n
\n basantnema31\n
@basantnema31
\n
\n bhavyapandiya29\n
@bhavyapandiya29
\n
\n bhavyasanthoshi02\n
@bhavyasanthoshi02
\n
\n codewithakshyaaa\n
@codewithakshyaaa
\n
\n dev-2006-prt\n
@dev-2006-prt
\n
\n developer-yash03\n
@developer-yash03
\n
\n dhanushrajvr\n
@dhanushrajvr
\n
\n dhruvpatel16120\n
@dhruvpatel16120
\n
\n dikshajha13\n
@dikshajha13
\n
\n gatiksolanki13\n
@gatiksolanki13
\n
\n iamprasoon2006-cell\n
@iamprasoon2006-cell
\n
\n itsdakshjain\n
@itsdakshjain
\n
\n jainiksha\n
@jainiksha
\n
\n jatingow\n
@jatingow
\n
\n jbkun069\n
@jbkun069
\n
\n jeetrouth\n
@jeetrouth
\n
\n jyotish6699\n
@jyotish6699
\n
\n kavin553\n
@kavin553
\n
\n knoxiboy\n
@knoxiboy
\n
\n kumudasrip\n
@kumudasrip
\n
\n madhavcodes25\n
@madhavcodes25
\n
\n mahi-8758\n
@mahi-8758
\n
\n mayurigade-hub\n
@mayurigade-hub
\n
\n mrdeyroy\n
@mrdeyroy
\n
\n mrinmoyChakraborty-mrinox\n
@mrinmoyChakraborty-mrinox
\n
\n mrudulaa11\n
@mrudulaa11
\n
\n n1o5\n
@n1o5
\n
\n naina-kashyap\n
@naina-kashyap
\n
\n nene-hana\n
@nene-hana
\n
\n nimkarprachi17\n
@nimkarprachi17
\n
\n nishtha-agarwal-211\n
@nishtha-agarwal-211
\n
\n nyxsky404\n
@nyxsky404
\n
\n omnipotentchaos\n
@omnipotentchaos
\n
\n palak-paliwal11\n
@palak-paliwal11
\n
\n parasmani-dev\n
@parasmani-dev
\n
\n parulpaliwal01\n
@parulpaliwal01
\n
\n pragya-manna\n
@pragya-manna
\n
\n prajwal2430\n
@prajwal2430
\n
\n prasad-0007\n
@prasad-0007
\n
\n priya05-git\n
@priya05-git
\n
\n r-sushanth08\n
@r-sushanth08
\n
\n rashiaggarwal06\n
@rashiaggarwal06
\n
\n rishabhahuja12\n
@rishabhahuja12
\n
\n rishit537\n
@rishit537
\n
\n ruhelamahi7-code\n
@ruhelamahi7-code
\n
\n sahitya0xsingh\n
@sahitya0xsingh
\n
\n sakshicoded111\n
@sakshicoded111
\n
\n sam-dwdkr404\n
@sam-dwdkr404
\n
\n samarthchawla2005\n
@samarthchawla2005
\n
\n sangitabera\n
@sangitabera
\n
\n sanrishi\n
@sanrishi
\n
\n sanzzzz-g\n
@sanzzzz-g
\n
\n sarv-tech\n
@sarv-tech
\n
\n shaktipy\n
@shaktipy
\n
\n shreyasarote07\n
@shreyasarote07
\n
\n shreyasgawande19\n
@shreyasgawande19
\n
\n siri-004\n
@siri-004
\n
\n snehacodes-2906\n
@snehacodes-2906
\n
\n snehanair-486\n
@snehanair-486
\n
\n ssuyashhhh\n
@ssuyashhhh
\n
\n steam-bell-92\n
@steam-bell-92
\n
\n sujitsingh8\n
@sujitsingh8
\n
\n tanishkakora\n
@tanishkakora
\n
\n tejask011\n
@tejask011
\n
\n tmdeveloper007\n
@tmdeveloper007
\n
\n twinkle0tech\n
@twinkle0tech
\n
\n unknown-tech-ui\n
@unknown-tech-ui
\n
\n vedansht2211\n
@vedansht2211
\n
\n vedant7007\n
@vedant7007
\n
\n vedika76\n
@vedika76
\n
\n vedikabajaj05\n
@vedikabajaj05
\n
\n vipul674\n
@vipul674
\n
\n vivekCS007\n
@vivekCS007
\n
\n yughpatel\n
@yughpatel
\n
\n yuvraj-k-singh\n
@yuvraj-k-singh
\n

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.


💬 Connect & Share

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

🎉 Happy Coding! 🎉

Made with ❤️ for Python learners everywhere

If you learned something new, don't forget to star the repo! ⭐

⬆ Back to Top

🙌 Contributors

  • sujitsingh8

  • vivekCS007

  • rishit537

  • vedika76

  • snehacodes-2906

  • Shivi-Srivastava-4444

  • Papia-tech

  • PIYUSH-NEXTGEN

  • Avneesh95

  • tanishkakora

  • anujsharma8d

  • MoonLawlier

  • Lavanya-Talele

  • prasad-0007

  • developer-yash03

About

15+ fun Python project, zero dependencies, beginner-friendly code with emoji UI.

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages