QUICKSTART.md

🚀 Quick Start Guide

Running Locally

Option 1: Using Make (Recommended)

# Set up everything
make setup

# Run the app
make run

Option 2: Manual Setup

# Create virtual environment
python3 -m venv venv

# Activate it
source venv/bin/activate  # On macOS/Linux
# or
venv\Scripts\activate  # On Windows

# Install dependencies
pip install -r requirements.txt

# Run the app
streamlit run app.py

📖 What to Explore

1. RGB Tab

Start here! Learn about the additive color model and see how red, green, and blue combine.

2. HSV/HSI Tab

Discover how hue, saturation, and value/intensity provide a more intuitive way to work with colors.

3. CIE-LAB Tab

Explore perceptually uniform colorspace and calculate color differences.

4. CMYK Tab

Understand the subtractive color model used in printing.

5. YCbCr Tab

Learn how chroma subsampling reduces file sizes in JPEG and video.

6. Gamma & White Balance Tab

Experiment with gamma correction and color temperature adjustment.

7. Color Blindness Tab

Simulate different types of color vision deficiency and test your designs for accessibility.

💡 Tips

• Upload your own images using the file uploader in each tab
• Adjust sliders to see real-time changes
• Compare before/after to understand transformations
• Read the insights at the bottom of each tab for key concepts

🎓 For Students

Work through the tabs in order to build understanding from basic (RGB) to advanced (perceptual spaces and corrections).

👨‍🏫 For Instructors

Use this tool to:

• Demonstrate concepts during lectures
• Assign hands-on exercises
• Show real-world applications
• Test design accessibility

🐛 Issues?

If you encounter any problems:

1. Make sure all dependencies are installed: make setup
2. Check Python version (3.8+ required)
3. Try with the sample images first before uploading custom images
4. Open an issue on GitHub

---

Happy exploring! 🎨