Skip to content

vedika76/python-mini-project

ย 
ย 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

358 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

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 Aayuiiitmg\n
@Aayuiiitmg
\n
\n AnushkaJagtap22\n
@AnushkaJagtap22
\n
\n Aqifcodes\n
@Aqifcodes
\n
\n Arpitawork24\n
@Arpitawork24
\n
\n Bhairavi-28\n
@Bhairavi-28
\n
\n C4aZy\n
@C4aZy
\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 Indrayani11-15\n
@Indrayani11-15
\n
\n Juhi4433\n
@Juhi4433
\n
\n Kartikeyji17\n
@Kartikeyji17
\n
\n KhushiVadadoriya\n
@KhushiVadadoriya
\n
\n Kunal241207\n
@Kunal241207
\n
\n Lavanya-Talele\n
@Lavanya-Talele
\n
\n Mayank251125\n
@Mayank251125
\n
\n Mounika-39\n
@Mounika-39
\n
\n Naveen-Boddepalli\n
@Naveen-Boddepalli
\n
\n NileshRaut2601\n
@NileshRaut2601
\n
\n PRODHOSH\n
@PRODHOSH
\n
\n PragatiNigam29\n
@PragatiNigam29
\n
\n Quantum3600\n
@Quantum3600
\n
\n Ranjanmaiti6\n
@Ranjanmaiti6
\n
\n SANDHIYAPRIYADHARSHINI\n
@SANDHIYAPRIYADHARSHINI
\n
\n Sanjhivvarshan-b-s\n
@Sanjhivvarshan-b-s
\n
\n Sparshjoshi-iit\n
@Sparshjoshi-iit
\n
\n Sreekuttan-007\n
@Sreekuttan-007
\n
\n Tech4Aditya\n
@Tech4Aditya
\n
\n TheBinaryAVA\n
@TheBinaryAVA
\n
\n Tiago-Vier-Preto\n
@Tiago-Vier-Preto
\n
\n Vanshikakhasat\n
@Vanshikakhasat
\n
\n Vinanthi07\n
@Vinanthi07
\n
\n abdullahxyz85\n
@abdullahxyz85
\n
\n abhi-nav-25\n
@abhi-nav-25
\n
\n advikdivekar\n
@advikdivekar
\n
\n ash-heinz\n
@ash-heinz
\n
\n ayushyadav0707\n
@ayushyadav0707
\n
\n codewithakshyaaa\n
@codewithakshyaaa
\n
\n developer-yash03\n
@developer-yash03
\n
\n dhanushrajvr\n
@dhanushrajvr
\n
\n gatiksolanki13-netizen\n
@gatiksolanki13-netizen
\n
\n iamprasoon2006-cell\n
@iamprasoon2006-cell
\n
\n itsdakshjain\n
@itsdakshjain
\n
\n jyotish6699\n
@jyotish6699
\n
\n kumudasrip\n
@kumudasrip
\n
\n madhavcodes25\n
@madhavcodes25
\n
\n mahi-8758\n
@mahi-8758
\n
\n mrinmoyChakraborty-mrinox\n
@mrinmoyChakraborty-mrinox
\n
\n nene-hana\n
@nene-hana
\n
\n nimkarprachi17\n
@nimkarprachi17
\n
\n nishtha-agarwal-211\n
@nishtha-agarwal-211
\n
\n parasmani-dev\n
@parasmani-dev
\n
\n prasad-0007\n
@prasad-0007
\n
\n priya05-git\n
@priya05-git
\n
\n sanzzzz-g\n
@sanzzzz-g
\n
\n shreyasarote7717-cyber\n
@shreyasarote7717-cyber
\n
\n shreyasgawande19\n
@shreyasgawande19
\n
\n ssuyashhhh\n
@ssuyashhhh
\n
\n vedikabajaj05\n
@vedikabajaj05
\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

  • Papia-tech

  • PIYUSH-NEXTGEN

  • Avneesh95

  • tanishkakora

  • anujsharma8d

  • MoonLawlier

  • Lavanya-Talele

  • prasad-0007

  • developer-yash03

About

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

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • JavaScript 57.3%
  • Python 23.9%
  • HTML 12.5%
  • CSS 6.3%