Elgato_dark/ashim
1
0
Fork 0
mirror of https://github.com/ashim-hq/ashim synced 2026-04-21 13:37:52 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
Stirling-PDF but for images. 30+ tools and local AI in a single Docker container - resize, compress, remove backgrounds, upscale, OCR, and more. No cloud, no telemetry. Your images never leave your machine.
312 commits 4 branches 81 tags 11 MiB
TypeScript 90.8%
Python 7.5%
JavaScript 0.7%
Dockerfile 0.6%
Shell 0.2%
Other 0.1%
Find a file
semantic-release-bot 51f10abb35 chore(release): 1.5.3 [skip ci] 
## [1.5.3](https://github.com/stirling-image/stirling-image/compare/v1.5.2...v1.5.3) (2026-04-04)

### Bug Fixes

* use heif-convert for HEIC decoding on Linux ([98553ed](98553ed674))
2026-04-04 13:55:46 +00:00
.github fix: install HEVC codec plugins for CI HEIC tests 2026-04-04 21:50:35 +08:00
.husky refactor: rename Tool.alpha to Tool.experimental 2026-03-26 01:10:51 +08:00
apps chore(release): 1.5.3 [skip ci] 2026-04-04 13:55:46 +00:00
docker feat: add HEIC/HEIF format support for input and output 2026-04-04 21:33:48 +08:00
docs/superpowers docs: add implementation plan for HTTP compatibility fix 2026-04-04 16:19:23 +08:00
images chore: add docs screenshot 2026-04-03 23:17:06 +08:00
packages chore(release): 1.5.3 [skip ci] 2026-04-04 13:55:46 +00:00
scripts feat: add semantic-release for automated versioning and help dialog 2026-03-22 21:25:14 +08:00
tests feat: add HEIC/HEIF format support for input and output 2026-04-04 21:33:48 +08:00
.dockerignore chore: remove dead code, add test infrastructure, update docs 2026-03-23 11:46:45 +08:00
.env.example feat: multi-arch Docker support, security hardening, and test improvements 2026-03-28 11:19:09 +08:00
.gitignore chore: remove CLAUDE.md from repo and keep it local-only 2026-03-26 12:06:06 +08:00
.releaserc.json fix: streamline CI/CD — remove broken AI docs updater, fix Docker publish 2026-03-23 15:14:34 +08:00
biome.json refactor: rename Tool.alpha to Tool.experimental 2026-03-26 01:10:51 +08:00
CHANGELOG.md chore(release): 1.5.3 [skip ci] 2026-04-04 13:55:46 +00:00
CONTRIBUTING.md chore: use first-person voice in license and CLA text 2026-04-03 23:11:19 +08:00
LICENSE chore: use first-person voice in license and CLA text 2026-04-03 23:11:19 +08:00
package.json chore(release): 1.5.3 [skip ci] 2026-04-04 13:55:46 +00:00
playwright.config.ts feat: multi-arch Docker support, security hardening, and test improvements 2026-03-28 11:19:09 +08:00
pnpm-lock.yaml feat: add worker threads, persistent Python sidecar, graceful shutdown, and architectural improvements 2026-03-29 17:23:41 +08:00
pnpm-workspace.yaml feat: initialize Turborepo monorepo with pnpm workspaces 2026-03-22 02:41:44 +08:00
README.md chore: use first-person voice in license and CLA text 2026-04-03 23:11:19 +08:00
tsconfig.base.json feat: initialize Turborepo monorepo with pnpm workspaces 2026-03-22 02:41:44 +08:00
turbo.json feat: initialize Turborepo monorepo with pnpm workspaces 2026-03-22 02:41:44 +08:00
vitest.config.ts fix: resolve multiple API and e2e test bugs 2026-04-04 17:44:51 +08:00

README.md

Stirling Image logo

Stirling Image

Stirling-PDF but for images. 30+ tools and local AI in a single Docker container.

Docker CI License Stars

Stirling Image - Dashboard

Key Features

  • 30+ image tools - Resize, crop, compress, convert, watermark, color adjust, and more
  • Local AI - Remove backgrounds, upscale images, erase objects, blur faces, extract text (OCR). All running on your hardware with pre-downloaded models, no internet required
  • Pipelines - Chain tools into reusable workflows. Batch process up to 200 images at once
  • REST API - Every tool available via API. Interactive docs included at /api/docs
  • Single container - One docker run, no Redis, no Postgres, no external services
  • Multi-arch - Runs on AMD64 and ARM64 (Intel, Apple Silicon, Raspberry Pi)
  • Your data stays yours - No telemetry, no tracking, no external calls. Images never leave your machine

Quick Start

docker run -d -p 1349:1349 -v stirling-data:/data stirlingimage/stirling-image:latest

Open http://localhost:1349 in your browser.

Default credentials:

Field Value
Username admin
Password admin

You will be asked to change your password on first login. This is enforced for all new accounts and cannot be skipped in production.

For Docker Compose, persistent storage, and other setup options, see the Getting Started Guide.

Documentation

Contributing

Contributions welcome. See CONTRIBUTING.md for guidelines, the Developer Guide for setup, and the Translation Guide for adding languages.

Support

Bug reports and feature requests: GitHub Issues

License

This project is dual-licensed under the AGPLv3 and a commercial license.

  • AGPLv3 (free): You may use, modify, and distribute this software under the AGPLv3. If you run a modified version as a network service, you must make your source code available under the AGPLv3. This applies to personal use, open-source projects, and any use that complies with AGPLv3 terms.
  • Commercial license (paid): If you want to use Stirling Image in proprietary software or SaaS without the AGPLv3 source-disclosure requirement, a commercial license is available. Contact me for pricing and terms.