Photo · Python · MIT

PhotoLab

Privacy-first local photo editor with smart enhancements, creative effects and creator tools.

View on GitHub Download ZIP

Overview

PeaBox Photo Lab is a privacy-first, local photo editor for creators, bloggers, small businesses, and everyday users. It runs in a browser while Python, Streamlit, Pillow, and NumPy perform the editing.

Highlights

  • Non-destructive adjustments and live before/after preview
  • Smart auto optimization and five creative presets
  • Light, colour, crop, rotate, mirror, borders, and watermark controls
  • Selective colour, duotone, dreamy glow, pencil sketch, pixel art, and vignette
  • Dominant colour palette extraction
  • Downloadable style proof sheet
  • Social format pack for square, portrait, landscape, and story crops
  • Image health check and fresh exports without copied EXIF metadata
  • Export presets for Web High Quality, Social 1080, and Archive PNG

Run locally

python -m venv .venv
pip install -r requirements.txt
streamlit run app.py

Privacy

When run locally, the application processes image bytes on your computer and does not intentionally persist uploads. Exports are newly encoded and original EXIF metadata is not copied. A remote deployment necessarily receives uploaded files on that server, so operators must secure the deployment.

Release Notes

v0.2.30 UI test coverage — Streamlit AppTest end-to-end suite covers every rendered menu option and interactive control (13 select boxes, 82 sliders, 12 toggles, 3 editable text inputs, 10 editable colour controls, the rotation selector, conditional custom dimensions, all three export formats, and the full preset inventory are exercised). Set PEABOX_TEST_MODE=1 only for automated testing.

← Back to RepositoriesMore Help →