Skip to content

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Image Playground 🎪

Image Playground is an interactive Streamlit application that offers a comprehensive suite of image processing, computer vision, and AI-powered tools. From simple filters to advanced deep learning capabilities, this app provides both fun and educational ways to explore digital imaging techniques.

Image Playground

Features

🎮 Interactive Tools

  • Photo Booth: Apply fun and advanced effects to webcam captures
  • Meme Factory: Create custom memes with your own images
  • Filtering Arcade: Apply various image filters with real-time previews
  • AI Art Studio: Generate images using Stable Diffusion (when connected)

📊 Educational Components

  • Histogram Analysis: Visualize and manipulate image histograms
  • Edge Detection: Explore feature detection algorithms
  • Fourier Transforms: Visualize images in the frequency domain
  • Image Segmentation: Try different segmentation techniques
  • Shape Analysis: Detect and analyze shapes in images
  • Object Detection: Identify objects using YOLO v8

🏆 Achievement System

Track your progress through various challenges including:

  • First Upload
  • Selfie Master
  • Meme Genius
  • Filter King
  • AI Explorer

Installation

Prerequisites

  • Python 3.8+
  • Pip package manager

Setup

  1. Clone this repository:
git clone https://github.com/yourusername/image-playground.git
cd image-playground
  1. Install the required packages:
pip install -r requirements.txt
  1. Run the app:
streamlit run app.py

Optional: Stable Diffusion Setup

For the AI Art Studio functionality, you need a running instance of Stable Diffusion with API access:

Option 1: AUTOMATIC1111 WebUI

git clone https://github.com/AUTOMATIC1111/stable-diffusion-webui.git
cd stable-diffusion-webui
python launch.py --api

Option 1: ComfyUI

git clone https://github.com/comfyanonymous/ComfyUI.git
cd ComfyUI
python main.py

The app will automatically detect a running Stable Diffusion instance at http://127.0.0.1:7860 by default.

Usage

After starting the app, navigate to the different pages using the sidebar menu:

  1. Welcome: View your achievements and get started
  2. Photo Booth 🎮: Capture images from your webcam and apply filters
  3. Meme Factory 😂: Create custom memes with text overlays
  4. Image Digitization: Explore pixel-level image properties
  5. Histogram & Metrics: Analyze image histograms and statistics
  6. Filtering & Enhancements: Apply various image filters
  7. Edge Detection & Features: Detect edges and extract features
  8. Transforms & Frequency Domain: Visualize Fourier transforms
  9. Image Restoration: Simulate and fix image degradation
  10. Segmentation & Representation: Segment images using various techniques
  11. Shape Analysis: Detect and analyze shapes in images
  12. Object Detection 🔍: Identify objects using YOLO v8
  13. AI Art Studio 🎨: Generate images with Stable Diffusion

Core Dependencies

  • Streamlit: For the interactive web interface
  • OpenCV: For core image processing functionality
  • NumPy: For numerical operations
  • Matplotlib: For plotting and visualization
  • Pillow: For image manipulation
  • Scikit-image: For additional image processing algorithms
  • Ultralytics & Supervision: For YOLO object detection

Troubleshooting

Common Issues

  1. Missing Dependencies:

    • Ensure all requirements are installed using pip install -r requirements.txt
    • For GPU acceleration, make sure compatible CUDA drivers are installed
  2. Webcam Access:

    • Browser permissions must allow webcam access
    • Check that no other applications are using your camera
  3. Stable Diffusion Connection:

    • Ensure Stable Diffusion is running with the --api flag
    • Check the API URL in the sidebar (default is http://127.0.0.1:7860)
    • For VRAM issues, try models that require less memory
  4. Object Detection Issues:

    • The app will download the YOLO model on first use
    • Ensure you have internet access for the initial download

Performance Tips

  • For slower computers, avoid using high-resolution images
  • Close other resource-intensive applications
  • For AI Art generation, lower image dimensions for faster results

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

License

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

Acknowledgments

  • Streamlit for the amazing web app framework
  • OpenCV and related libraries for image processing capabilities
  • Ultralytics for YOLO implementation
  • Stable Diffusion for AI image generation
  • All contributors and testers who have helped improve this app

Note: This application is designed for educational purposes to demonstrate various image processing and computer vision techniques. Some features like AI Art Studio require additional setup of external services.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages