Skip to content

README.md

Latest commit

 

History

History
475 lines (360 loc) · 11.7 KB

README.md

File metadata and controls

475 lines (360 loc) · 11.7 KB

🎮 Python Mini Projects Collection 🎯

Learn Python by Building Fun, Interactive Games & Tools!

Python Version License Projects Code Scanning

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

Quick Start • Projects • Features • Contributing

🎯 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 20 projects in your browser with beautiful animations and visualizations!

# Clone the repository
git clone https://github.com/yourusername/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! 🎉

🎮 Projects

🚀 Physics & Simulation

🎯 Projectile Motion Game

Launch projectiles and visualize trajectory stats!

  • 🚀 Simple launch simulation
  • 📊 Shows TOF, Hmax, and Range
  • 📈 Matplotlib plot for each launch
python math/Projectile-Motion-Game/Projectile-Motion-Game.py

🎲 Games - Test Your Luck & Skills!

🪨 Rock, Paper, Scissors

Battle against the computer in this classic game!

  • 🎯 Interactive gameplay
  • 🤖 Smart computer opponent
  • 🎨 Visual feedback for wins/losses
python games/Rock-Paper-Scissor/Rock-Paper-Scissor.py

🎲 Dice Rolling

Roll two dice and see your fortune!

  • ⚀⚁⚂ Realistic dice emojis
  • 📊 Total calculation
  • 🎰 Perfect for board game nights
python games/Roling-Dice/Roling-Dice.py

🧭 Coordinate to Polar Transformation

Convert Cartesian coordinates into polar representation!

  • 📍 Input (x, y) coordinates
  • 📏 Computes radius r = sqrt(x^2 + y^2)
  • 📐 Shows angle in both degrees and radians
python math/Coordinate-to-Polar-Transformation/Coordinate-to-Polar-Transformation.py

∂ Derivative Calculator

Perform full polynomial derivative operations!

  • 🧮 First derivative and nth derivative support
  • 📍 Evaluate derivative value at any x
  • ✍️ Input polynomial using coefficient list
python math/Derivative-Calculator/Derivative-Calculator.py

🪙 Coin Flip

Can you predict heads or tails?

  • 👑 Heads vs 🦅 Tails
  • 🎭 Simple yet addictive
  • ⚡ Quick decision maker
python games/Flipping-toss/Flipping-toss.py

🎯 Number Guessing Game

Think you can read the computer's mind?

  • 🤔 Interactive guessing
  • 📈📉 Smart hints
  • 🎊 Celebratory win screen
python games/Number-Guessing-Game/Number-Guessing-Game.py

🎮 Hangman Game

Classic word-guessing game!

  • 📝 Random word selection
  • ❤️ 6 attempts to guess
  • 🔤 Track guessed letters
python games/Hangman-Game/Hangman-Game.py

💖 FLAMES Game

Discover your relationship status!

  • 👫 Enter two names
  • 🔮 Magical calculation
  • 💕 Friends, Love, Affection, Marriage, Enemies, or Siblings
python games/FLAMES-Game/FLAMES-Game.py

📐 AP/GP/AGP/HP Recognizer

Identify progression types from a number sequence!

  • 🔍 Detects Arithmetic, Geometric, Arithmetic-Geometric, and Harmonic patterns
  • 🧠 Supports integer and decimal values
  • 📘 Great for quick sequence practice
python math/AP-GP-AGP-HP-Recognizer/AP-GP-AGP-HP-Recognizer.py

🔢 Mathematical Wizards - Explore Number Magic!

✨ Fibonacci Series

Generate beautiful mathematical sequences

  • 🌀 Classic Fibonacci pattern
  • 📊 Visual array display
  • ➡️ Arrow-based formatting
python math/Fibonacci-Series/Fibonacci-Series.py

🔺 Pascal's Triangle

Discover mathematical beauty in triangles!

  • 🎨 Centered triangle display
  • 🔍 View specific rows
  • 📐 Interactive exploration
python math/Pascal-Triangle/Pascal-Triangle.py

💎 Armstrong Number Checker

Uncover special numbers with unique properties!

  • 🔢 Detailed calculation breakdown
  • ✅ Instant verification
  • 💡 Educational examples
python math/Armstrong-Number/Armstrong-Number.py

🧮 Simple Calculator

Your mathematical companion!

  • ➕➖✖️➗ All basic operations
  • 💪 Power & modulus support
  • 🎨 Clean menu interface
python math/Simple-Calculator/Simple-Calculator.py

🔢 Collatz Conjecture

Explore the famous 3n+1 problem!

  • 🌀 Generate complete sequence
  • 📊 Track steps and statistics
  • 🎯 Watch numbers reach 1
python math/Collatz-Conjecture/Collatz-Conjecture.py

🔱 Prime Number Analyzer

All-in-one prime number toolkit!

  • ✅ Check if number is prime
  • 📈 Generate primes up to N
  • 🎯 Find primes in range
  • 🧩 Prime factorization
python math/Prime-Number-Analyzer/Prime-Number-Analyzer.py

🔐 Crypto & Utilities - Encode Your Secrets!

📻 Morse Code Translator

Transform text into dots and dashes!

  • 🔄 Bidirectional translation
  • 📊 Complete Morse chart
  • 💬 Supports letters, numbers & symbols
python utilities/Text-to-Morse/Text-to-Morse.py

🗼 Tower of Hanoi

Solve the classic puzzle step by step!

  • 🎯 1-8 disks to solve
  • 📋 Visual tower representation
  • 🧠 Iterative solution display
python utilities/Tower-of-Hanoi/Tower-of-Hanoi.py

✨ Features

🌐 Interactive Web Application

  • All 20 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

🎓 What You'll Learn

Working through these projects, you'll master:

  • ✅ User Input & Output - Interactive console applications
  • ✅ Control Flow - if/elif/else, while loops
  • ✅ Data Structures - Lists, dictionaries, arrays
  • ✅ Randomization - Using the random module
  • ✅ String Manipulation - Text processing and formatting
  • ✅ Mathematical Operations - Calculations and algorithms
  • ✅ Geometric Patterns - Understanding shapes and symmetry
  • ✅ Logic & Problem Solving - Building real-world applications

🚀 Getting Started Guide

🌐 Web Application (Easiest Way!)

  1. Clone the repository

    git clone https://github.com/yourusername/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 20 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

Python Projects

  • Use emojis for visual appeal 🎨
  • Keep code simple and beginner-friendly 📚
  • No external dependencies 💯
  • Include clear instructions ✅
  • Add docstrings and comments 📝

Web App Projects

  • Match the existing design patterns
  • Use vanilla JavaScript (no frameworks)
  • Implement in getProjectHTML() and initProject() functions
  • Include animations and visual feedback
  • Ensure responsive design

See CONTRIBUTING.md for detailed guidelines.

📝 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