Siddharth Kumar Sah
adc7e1c037
Replace placeholder "default settings" message with actual form controls when expanding pipeline steps. Each tool now shows its configurable fields (dimensions, quality, colors, modes, etc.) directly in the pipeline builder. Covers all 30+ tools with data-driven field definitions: number inputs, select groups, checkboxes, color pickers, and conditional fields.
Stirling Image
The Open-Source Image Processing Platform
A self-hosted, privacy-first image processing suite with 37+ tools. Resize, compress, convert, watermark, remove backgrounds, and more — all from a single Docker container. No data ever leaves your server.
Inspired by Stirling-PDF, built for images.
Quick Start
docker run -d -p 1349:1349 -v ./data:/data ghcr.io/siddharthksah/stirling-image:latest
Then open http://localhost:1349.
Key Capabilities
-
37+ image tools — Resize, crop, rotate, compress, convert, watermark, color adjustments, and more in one place.
-
AI-powered processing — Background removal (rembg), image upscaling (Real-ESRGAN), OCR text extraction, face/PII auto-blurring, and smart cropping — all running locally.
-
Privacy first — Every operation runs on your hardware. No files are sent to external servers. No telemetry, no tracking, no cloud dependencies.
-
Batch processing — Drop 200 images, apply any tool, download results as a ZIP. Concurrent processing with configurable limits.
-
Automation pipelines — Chain tools into reusable workflows (e.g., Resize, Compress, Convert to WebP, Strip Metadata). Save and reuse pipelines.
-
Full API — Every tool is available via REST API with Swagger documentation at
/api/docs. Automate image processing from scripts, CI/CD, or other tools. -
Self-hosted & portable — Single Docker container. Works on Intel, AMD, and Apple Silicon (multi-arch:
linux/amd64+linux/arm64).
Tools
| Category | Tools |
|---|---|
| Essentials | Resize, Crop, Rotate & Flip, Convert, Compress |
| Optimization | Strip Metadata, Bulk Rename, Image to PDF, Favicon Generator |
| Adjustments | Brightness/Contrast, Saturation, Color Channels, Color Effects, Replace Color |
| AI Tools | Background Removal, Upscaling, Object Eraser, OCR, Face Blur, Smart Crop |
| Watermark | Text Watermark, Image Watermark, Text Overlay, Image Composition |
| Utilities | Image Info, Compare, Find Duplicates, Color Palette, QR Generator, Barcode Reader |
| Layout | Collage/Grid, Image Splitting, Border & Frame |
| Format | SVG to Raster, Image to SVG, GIF Tools |
| Automation | Pipeline Builder, Batch Processing |
Supported Formats
Input: JPG, PNG, WebP, AVIF, TIFF, BMP, GIF (animated), SVG, HEIC/HEIF, JPEG XL, ICO, RAW (CR2, NEF, ARW, DNG)
Output: JPG, PNG, WebP, AVIF, TIFF, GIF, JPEG XL, SVG, ICO, PDF
Configuration
| Variable | Default | Description |
|---|---|---|
PORT |
1349 |
Application port |
AUTH_ENABLED |
true |
Enable login (default credentials: admin / admin) |
MAX_UPLOAD_SIZE_MB |
100 |
Maximum file upload size |
MAX_BATCH_SIZE |
200 |
Maximum files per batch |
CONCURRENT_JOBS |
3 |
Parallel processing limit |
FILE_MAX_AGE_HOURS |
24 |
Auto-cleanup temp files after this duration |
STORAGE_MODE |
local |
Storage backend (local or s3) |
See .env.example for the full list.
Docker Compose
services:
stirling-image:
image: ghcr.io/siddharthksah/stirling-image:latest
container_name: stirling-image
ports:
- "1349:1349"
volumes:
- stirling-data:/data
restart: unless-stopped
volumes:
stirling-data:
Development
git clone https://github.com/siddharthksah/Stirling-Image.git
cd Stirling-Image
pnpm install
pnpm dev
# UI: http://localhost:1349
Requires Node.js 22+ and pnpm 9+.
Tech Stack
- Frontend: React 19, Vite, Tailwind CSS 4, shadcn/ui
- Backend: Fastify, Sharp (libvips), Drizzle ORM, SQLite
- AI/ML: Python (rembg, Real-ESRGAN, PaddleOCR, MediaPipe)
- Infrastructure: Turborepo monorepo, Docker multi-arch
Contributing
Contributions are welcome. Please open an issue first to discuss what you'd like to change.