Current release: v0.2.30
Release ZIP naming: peabox-photo-lab-v<version>.zip
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.
- 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
- JPEG, PNG, and WebP export
- Export presets for Web High Quality, Social 1080, and Archive PNG
Double-click run_windows.bat.
chmod +x run_linux_mac.sh
./run_linux_mac.shpython -m venv .venv
# Windows: .venv\Scripts\activate
# Linux/macOS: source .venv/bin/activate
python -m pip install -r requirements.txt
streamlit run app.pyWhen 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.
python, streamlit, pillow, photo-editor, image-processing, creator-tools, privacy-first, webp, peabox
Read CONTRIBUTING.md. Report security issues using SECURITY.md, not a public issue.
MIT
- Black & white and negative quick effects
- Custom export width/height with optional aspect-ratio preservation
- Live output dimensions and encoded file-size preview
- Adjustable Sepia effect
- Exposure Analysis in Image Inspector
- Automatic warnings for excessive deep shadows or bright highlights
- Corrected custom-dimension export flow
- Portrait Soft, Cinematic, and High Key styles
- Adjustable Clarity and Noise Reduction
- Email Compact and 4K Display export presets
- Expanded proof sheet with the latest styles
- Posterize and Solarize creative effects
- RGB Channel Mixer with independent 50-150% controls
- Privacy PNG lossless export preset
- Megapixel reporting alongside output resolution and encoded size
- Matte/Fade creative finishing control
- Adjustable Film Grain
- Split Toning with shadow and highlight hue controls
- Photo Print high-quality JPEG export preset
- Adjustable Lens Vignette with edge softness control
- Date or caption stamping in any corner
- Phone Wallpaper and Square Profile export presets
- Soft Focus finishing tool for gentle diffusion
- Fine Detail enhancement for texture definition
- Messaging JPEG and Web Thumbnail WebP export presets
- Richer export summary including format and quality status
- Exposure adjustment from -2.0 EV to +2.0 EV
- Adaptive Vibrance for stronger low-saturation color enhancement
- Edge Sharpen for additional structural crispness
- Portfolio and Low Bandwidth WebP presets
- Gamma control from 0.50 to 2.00
- Green-to-magenta Tint correction
- Auto Levels with adjustable 0-10% cutoff
- Presentation HD and Presentation 4K export presets
- Adjustable Auto White Balance based on the Gray World method
- Micro Contrast for local texture and dimensionality
- Highlight Fade for softer bright tones
- Blog Optimized WebP and Master JPEG export presets
- Dehaze for improved clarity in hazy or washed-out photos
- Bloom/Glow for soft luminous highlights
- Color Cast Analysis with RGB means and channel-spread guidance
- Gallery WebP and Quick Share export presets
- Texture Clarity for broader local detail enhancement
- Independent shadow-color hue/strength grading
- Independent highlight-color hue/strength grading
- Social High Quality and Proof JPEG export presets
- Chromatic Pop for saturation-aware color enhancement
- Soft Skin diffusion control
- Composition Safe Area preview overlay with adjustable margins
- Mobile WebP and Client Review export presets
- Monochrome Channel Mixer with independent RGB weighting
- Luminance-mask preview for highlights, midtones, and shadows
- Adjustable mask overlay opacity
- Contact Sheet Web and Lossless Master export presets
- Black Point and White Point tone-range controls
- Auto Temperature Correction
- Focus Analysis with editing guidance
- Desktop Wallpaper and Fast Preview export presets
- Defringe / Chromatic Cleanup for strong color-edge artifacts
- Orton Glow creative finishing effect
- Dynamic Range analysis in Image Inspector
- Marketplace JPEG and Tiny Web WebP export presets
- Presence / Atmospheric Clarity from -100 to +100
- Color Density from -100 to +100
- Image Inspector clipping check for near-black and near-white channels
- Portfolio Master and Chat Optimized export presets
- Targeted Colour saturation adjustment by selectable hue and range
- Noise Analysis with practical denoise/sharpen guidance
- Email Small and Web Hero export presets
- Local Dodge/Burn with adjustable X/Y position, radius, and strength
- Tonal Entropy / Image Complexity analysis
- Detailed Web and Draft Proof export presets
- Tilt-Shift focus-band effect
- Custom frame size and colour
- Compression Advisor with suggested JPEG/WebP quality
- Print Proof and Ultra Web export presets
- Radial Focus with adjustable focus point, radius, and blur strength
- Custom Color Wash with selectable colour and intensity
- Resolution Advisor with megapixel and image-size classification
- Retina Web and Original Backup presets
- Center Light for localized radial brightening/darkening
- Smart Export Recommendation with suggested quality and long edge
- Color Neutrality metric
- Smart Web and High Res JPEG export presets
- Directional Graduated Filter with selectable colour and strength
- Luminance Balance analysis using mean and median brightness
- Editorial Web and Archive JPEG export presets
- Custom Edge Fade with selectable colour and intensity
- Preview-only Rule-of-Thirds grid
- Composition Advisor with orientation-specific guidance
- Story Portrait and Slide Ready export presets
- Two-colour horizontal Gradient Toning
- Preview-only Horizon Guide
- Common Aspect Ratio Advisor
- Cinematic Web and Social Master export presets
- Custom Corner Tint
- Preview-only Diagonal Composition Guide
- Subject Emphasis analysis with editing recommendations
- Profile Master and Web Standard export presets
- UI and image-processing core separated into
app.pyandpeabox_core.py. - Automated pytest coverage for core transforms, regressions, edge dimensions, analysis contracts, and JPEG/PNG/WebP encoding.
validate_release.pyprovides a repeatable local release gate.- GitHub Actions quality workflow runs validation and tests on push and pull request.
- Export presets are grouped for easier navigation; the All presets group preserves the complete legacy preset inventory.
pip install -r requirements.txt -r requirements-dev.txt
python validate_release.py
pytest- 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.
- 284 UI action/state checks are performed across the test suite.
- Set
PEABOX_TEST_MODE=1only for automated testing; it supplies a deterministic generated image and does not change the normal upload-first experience.
pip install -r requirements.txt -r requirements-dev.txt
python validate_release.py
pytest