Skip to content

Latest commit

 

History

History
479 lines (335 loc) · 10.7 KB

Readme.md

File metadata and controls

479 lines (335 loc) · 10.7 KB

🐍 Python Projects Collection

Python License Projects Status

A curated collection of Python projects showcasing automation, AI, multimedia processing, and practical utilities

Getting Started • Projects • Tech Stack • Contributing

📋 Table of Contents

🚀 Getting Started

# Clone the repository
git clone https://github.com/Pratham-Prog861/Python-Projects.git

# Navigate to a specific project
cd <project-folder>

# Install dependencies (if requirements.txt exists)
pip install -r requirements.txt

# Run the project
python <main-file>.py

🎯 Projects

🎮 Tic-Tac-Toe Game

Classic two-player game with a clean GUI interface

📂 tic-tac-toe/
└── tictactoe.py

Features:

  • Interactive GUI using Tkinter
  • Two-player gameplay
  • Win detection algorithm
  • Clean and intuitive interface

Run:

cd tic-tac-toe
python tictactoe.py

🎥 Screen Recorder

Capture your screen activity and save as video

📂 screen recorder/
└── sr.py

Features:

  • Real-time screen capture
  • Video file output
  • Keyboard interrupt handling

Run:

cd "screen recorder"
python sr.py
# Press Ctrl+C to stop recording

Tech: pyautogui, cv2, numpy

✍️ Spell Checker

Intelligent spell checking utility for text validation

📂 spell checker/
└── spellchecker.py

Features:

  • Real-time spell checking
  • Suggestion engine
  • Custom dictionary support

Run:

cd "spell checker"
python spellchecker.py

Tech: spellchecker

💰 Rent Calculator

Split rent fairly among roommates

📂 rent calculator/
└── rentCalculator.py

Features:

  • Multi-person rent splitting
  • Custom calculation logic
  • User-friendly interface

Run:

cd "rent calculator"
python rentCalculator.py

🖼️ Slideshow

Automated image slideshow viewer

📂 slideshow/
└── slideshow.py

Features:

  • Automatic image transitions
  • Customizable timing
  • Support for multiple formats

Run:

cd slideshow
python slideshow.py

Tech: PIL/Pillow, tkinter

📱 QR Code Generator

Generate QR codes for UPI payments and more

📂 qrcode/
└── qrcode.py

Features:

  • UPI payment QR generation
  • Customizable QR codes
  • High-quality output

Run:

cd qrcode
python qrcode.py

Tech: qrcode, PIL

🎬 ASCII Video Player

Convert videos to ASCII art in real-time

📂 ascii-video/
├── main.py
├── pyproject.toml
├── uv.lock
└── vid.mp4

Features:

  • Video to ASCII conversion
  • Real-time playback
  • Modern Python packaging with uv

Run:

cd ascii-video
python main.py

Tech: opencv-python, numpy

🤖 AI Task Agent

Intelligent task management agent powered by AI

📂 ai-agent/
├── task_agent.py
├── tasks.txt
├── .env
└── .gitignore

Features:

  • AI-powered task processing
  • Environment configuration
  • Task persistence

Run:

cd ai-agent
python task_agent.py

Tech: AI/ML libraries, environment management

🗄️ Python MongoDB Integration

Database operations with MongoDB

📂 python_mongodb/
├── main.py
├── requirements.txt
├── .env
└── .env.example

Features:

  • MongoDB CRUD operations
  • Environment-based configuration
  • Secure credential management

Setup:

cd python_mongodb
cp .env.example .env
# Edit .env with your MongoDB credentials
pip install -r requirements.txt
python main.py

Tech: pymongo, python-dotenv

📝 FastAPI Notes App

Full-stack notes application with FastAPI backend and vanilla JavaScript frontend

📂 fastapi-notes/
├── main.py
├── database.py
├── models.py
├── schemas.py
├── index.html
├── requirements.txt
├── .env
└── .env.example

Features:

  • RESTful API with FastAPI
  • MongoDB Atlas integration for cloud storage
  • CRUD operations (Create, Read, Update, Delete)
  • Single-page application with vanilla JavaScript
  • Modern UI with Tailwind CSS
  • Dark mode support
  • Real-time search functionality
  • Toast notifications
  • Responsive design

Setup:

cd fastapi-notes
cp .env.example .env
# Edit .env with your MongoDB Atlas credentials
pip install -r requirements.txt

Run:

# Start the FastAPI server
uvicorn main:app --reload

# Open index.html in your browser or serve it with:
python -m http.server 8080
# Then visit http://localhost:8080

API Endpoints:

  • POST /notes/ - Create a new note
  • GET /notes/ - Get all notes
  • GET /notes/{note_id} - Get a specific note
  • PUT /notes/{note_id} - Update a note
  • DELETE /notes/{note_id} - Delete a note

Tech: fastapi, uvicorn, pymongo, pydantic, python-dotenv, tailwindcss, vanilla-js

✨ Doctor Strange Hand Gestures

Create magical effects with hand gestures using computer vision

📂 docter-strange/
├── main.py
├── functions.py
├── config.json
├── requirements.txt
└── Models/
    ├── inner_circles/
    └── outer_circles/

Features:

  • Real-time hand tracking using MediaPipe
  • Gesture-based spell casting effects
  • Dynamic shield generation when hand is spread
  • Rotating magical circles overlay
  • Configurable visual effects and camera settings

How it works:

  • Spell Mode: When fingers are close together, magical lines connect from wrist to fingertips
  • Shield Mode: When hand is spread wide, rotating magical circles appear creating a shield effect
  • Hand gesture ratios determine which effect is displayed

Run:

cd docter-strange
pip install -r requirements.txt
python main.py
# Press 'q' to quit

Tech: opencv-python, mediapipe, numpy

🛠️ Tech Stack

Category Technologies
Core Python
Web Framework FastAPI
Frontend JavaScript TailwindCSS
GUI Tkinter
Computer Vision OpenCV MediaPipe
Database MongoDB
Automation PyAutoGUI
Image Processing Pillow

Key Libraries

  • fastapi - Modern web framework for building APIs
  • uvicorn - ASGI server for FastAPI
  • pydantic - Data validation using Python type hints
  • tkinter - GUI development
  • opencv-python (cv2) - Computer vision and video processing
  • mediapipe - Hand tracking and gesture recognition
  • pyautogui - GUI automation
  • spellchecker - Spell checking functionality
  • Pillow (PIL) - Image manipulation
  • qrcode - QR code generation
  • pymongo - MongoDB database driver
  • python-dotenv - Environment variable management

💡 Use Cases

These projects are perfect for:

  • 🎓 Learning Python - Hands-on examples of Python concepts
  • 🔧 Automation - Automate repetitive tasks
  • 🎨 Multimedia Processing - Work with images and videos
  • 🌐 Web Development - Build modern REST APIs and web apps
  • 🗃️ Database Operations - Learn MongoDB integration
  • 🤖 AI Integration - Explore AI-powered applications
  • 🛠️ Utility Tools - Practical everyday utilities

📦 Installation

Most projects require external dependencies. Install them using:

# For individual projects with requirements.txt
pip install -r requirements.txt

# Common dependencies
pip install tkinter pyautogui opencv-python spellchecker pillow qrcode pymongo python-dotenv

🤝 Contributing

Contributions are welcome! Feel free to:

  • 🐛 Report bugs
  • 💡 Suggest new features
  • 🔀 Submit pull requests
  • ⭐ Star this repository

Made with ❤️ and Python

⭐ Star this repo if you find it helpful!