Skip to content

A collection of Python scripts to automate everyday tasks and solve common problems — from file management and productivity to web scraping and personal utilities.

License

Notifications You must be signed in to change notification settings

Vaibhav2154/PyEveryday

Repository files navigation

OSCI-Project-Banner.png

🚀 PyEveryday

Automate Your Everyday Tasks with Modern Web Technology

GitHub stars GitHub forks GitHub issues License: MIT Python 3.8+ FastAPI Next.js

🌐 Live Demo • 📚 Documentation • 🤝 Contributing • 💬 Support


🌟 What is PyEveryday?

PyEveryday is an open-source platform that transforms everyday Python automation scripts into accessible web applications. No more command-line interfaces or local installations – just visit our web app and automate your tasks instantly!

🎯 Mission

To make powerful automation tools accessible to everyone through intuitive web interfaces, bridging the gap between complex Python scripts and user-friendly applications.

✨ Key Highlights

  • 🌐 Web-First Approach: All scripts accessible through modern web interface
  • 🚀 No Installation Required: Use directly from your browser
  • 📱 Mobile Friendly: Responsive design for all devices
  • 🔧 API-Driven: FastAPI backend with comprehensive REST API
  • ⚡ Real-time Results: Instant feedback and processing
  • 🔒 Secure: Privacy-focused with no data storage

🚀 Features

🔧 Utility Tools

  • 💱 Currency Converter - Real-time exchange rates with 150+ currencies
  • 📏 Unit Converter - Length, weight, temperature, and more
  • 🎂 Age Calculator - Precise age calculation with detailed breakdowns
  • 🔐 Password Generator - Secure passwords with customizable criteria

📈 Productivity Suite

  • ✅ Todo Manager - Smart task management with priorities
  • 🍅 Pomodoro Timer - Focus sessions with break reminders
  • 💡 Quote Fetcher - Daily motivation and inspiration
  • ⏰ Reminder System - Custom notifications and alerts
  • 📊 Time Tracker - Monitor time spent on activities

🤖 Automation Tools

  • 📁 File Organizer - Smart file sorting and management
  • 📧 Email Automation - Scheduled email sending
  • 🔄 Backup Scheduler - Automated backup solutions
  • 👁️ Folder Monitor - Real-time file system watching
  • 📝 File Renamer - Batch renaming with patterns

🌐 Data & Web Tools

  • 🌤️ Weather Checker - Current weather and forecasts
  • 📰 News Fetcher - Latest headlines from multiple sources
  • 📹 YouTube Downloader - Video/audio download utility
  • 🔍 Web Scraper - Custom data extraction tools
  • 📊 Data Processor - CSV, JSON, XML manipulation
  • 📈 Data Visualizer - Interactive charts and graphs

🎨 Media Processing

  • �️ Image Processor - Resize, convert, and optimize images
  • 🎵 Audio Processor - Audio format conversion and editing

🔒 Security Tools

  • 🛡️ Password Checker - Password strength analysis
  • 🔐 Security Utilities - Data protection and encryption

🏗️ Architecture

PyEveryday uses a modern full-stack architecture:

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   Next.js UI   │◄──►│  FastAPI Backend │◄──►│ Python Scripts │
│                 │    │                 │    │                 │
│ • React 18      │    │ • REST API      │    │ • Core Logic    │  
│ • TypeScript    │    │ • Authentication│    │ • Automation    │
│ • Tailwind CSS │    │ • Validation    │    │ • Processing    │
│ • Responsive    │    │ • Error Handling│    │ • Utilities     │
└─────────────────┘    └─────────────────┘    └─────────────────┘

Tech Stack

Frontend (Next.js)

  • React 18 with TypeScript
  • Tailwind CSS for styling
  • Responsive design
  • Progressive Web App (PWA)

Backend (FastAPI)

  • Python 3.8+ with FastAPI
  • Automatic API documentation
  • Input validation with Pydantic
  • CORS middleware for web integration

Scripts & Utilities

  • Pure Python with minimal dependencies
  • Modular and reusable functions
  • Comprehensive error handling
  • Well-documented APIs

🚀 Quick Start

🌐 Use Online (Recommended)

Visit our live application at: pyeveryday.app (Coming Soon)

No installation required! Access all tools directly from your browser.

💻 Local Development

Prerequisites

  • Python 3.8 or higher
  • Node.js 16 or higher
  • npm or yarn

Backend Setup

# Clone the repository
git clone https://github.com/Vaibhav2154/PyEveryday.git
cd PyEveryday

# Set up Python environment
cd backend
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt

# Start the FastAPI server
uvicorn app:app --reload --host 0.0.0.0 --port 8000

Frontend Setup

# In a new terminal, set up Next.js
cd ui
npm install

# Start the development server
npm run dev

Access the application at http://localhost:3000

📚 API Documentation

Once the backend is running, visit:

  • Interactive API Docs: http://localhost:8000/docs
  • ReDoc Documentation: http://localhost:8000/redoc

� Documentation


🤝 Contributing

We welcome contributions from developers of all experience levels! PyEveryday is built by the community, for the community.

🎯 Ways to Contribute

  • 🐛 Report Bugs - Found an issue? Let us know!
  • 💡 Suggest Features - Have ideas for new tools or improvements?
  • 📝 Improve Documentation - Help make our docs even better
  • 🔧 Code Contributions - Add new scripts or enhance existing ones
  • 🎨 UI/UX Improvements - Make the interface more user-friendly
  • 🧪 Write Tests - Help us maintain code quality

🚀 Quick Contribution Guide

  1. Fork the repository
  2. Clone your fork: git clone https://github.com/yourusername/PyEveryday.git
  3. Create a feature branch: git checkout -b feature/amazing-new-tool
  4. Make your changes and commit: git commit -m 'Add amazing new tool'
  5. Push to your branch: git push origin feature/amazing-new-tool
  6. Create a Pull Request

For detailed contribution guidelines, see CONTRIBUTING.md


📁 Project Structure

PyEveryday/
├── 📁 backend/                 # FastAPI backend
│   ├── app.py                  # Main FastAPI application
│   ├── config.py               # Configuration settings
│   ├── requirements.txt        # Python dependencies
│   ├── 📁 routers/            # API route handlers
│   │   └── 📁 auth/           # Authentication routes
│   └── 📁 scripts/            # Core Python scripts
│       ├── 📁 automation/     # Automation tools
│       ├── 📁 data_tools/     # Data processing
│       ├── 📁 productivity/   # Productivity suite
│       ├── 📁 utilities/      # General utilities
│       ├── 📁 web_scraping/   # Web scraping tools
│       ├── 📁 security/       # Security utilities
│       └── 📁 image_audio_video/ # Media processing
│
├── 📁 ui/                      # Next.js frontend
│   ├── package.json           # Node.js dependencies
│   ├── next.config.ts         # Next.js configuration
│   ├── 📁 app/               # App router pages
│   └── 📁 public/            # Static assets
│
├── 📁 docs/                   # Comprehensive documentation
├── 📁 tests/                  # Test suites
├── 📁 .github/               # GitHub workflows and templates
├── README.md                  # This file
├── CONTRIBUTING.md            # Contribution guidelines
├── LICENSE                    # MIT License
└── docker-compose.yml         # Docker deployment

🏆 Showcase

🌟 Featured Tools

Tool Description Frontend API
Currency Converter Real-time exchange rates
Password Generator Secure password creation
Todo Manager Task management system
Weather Checker Live weather data
File Organizer Smart file management 🚧

✅ = Available, 🚧 = In Development


🌍 Community

Join our growing community of developers and automation enthusiasts!

  • 💬 Discord - Real-time chat and support
  • 🐛 Issues - Bug reports and feature requests
  • 📋 Discussions - Ideas and general discussions
  • 📧 Email - Direct contact for important matters

🎉 Contributors

Thanks to all our amazing contributors!


📊 Stats & Metrics

GitHub commit activity GitHub last commit GitHub code size in bytes GitHub repo size


🗺️ Roadmap

🎯 Current Focus (Q4 2024)

  • Complete web interface for all existing scripts
  • User authentication and personalization
  • API rate limiting and security enhancements
  • Mobile app (React Native)

🚀 Upcoming Features (2025)

  • AI-powered automation suggestions
  • Plugin system for third-party integrations
  • Advanced data analytics dashboard
  • Workflow builder with visual editor
  • Team collaboration features
  • Enterprise edition with advanced security

🔒 Security & Privacy

  • 🛡️ Privacy First - No personal data stored unless explicitly needed
  • 🔐 Secure by Design - All communications use HTTPS/TLS
  • 🏠 Local Processing - Most operations happen in your browser
  • 📋 Transparent - Open source code you can audit
  • 🔄 Regular Updates - Security patches and improvements

For security concerns, please email: security@pyeveryday.app


📄 License

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

📋 What this means:

  • ✅ Commercial use allowed
  • ✅ Modification allowed
  • ✅ Distribution allowed
  • ✅ Private use allowed
  • ❌ No warranty provided
  • ❌ No liability accepted

� Acknowledgments

  • FastAPI team for the amazing web framework
  • Next.js team for the powerful React framework
  • Vercel for seamless deployment solutions
  • All contributors who make this project possible
  • Open source community for inspiration and support

📞 Support

Need help? We're here for you!


⭐ Star us on GitHub — it motivates us a lot!

Made with ❤️ by Vaibhav M N and the PyEveryday Community

"Automate today, innovate tomorrow"

About

A collection of Python scripts to automate everyday tasks and solve common problems — from file management and productivity to web scraping and personal utilities.

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 14