https://github.com/ashim-hq/ashim
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.
https://github.com/ashim-hq/ashim
ai docker homelab image-editor image-processing open-source self-hosted
Last synced: about 2 months ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/ashim-hq/ashim
- Owner: ashim-hq
- License: other
- Created: 2026-03-29T15:33:21.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-14T15:05:13.000Z (about 2 months ago)
- Last Synced: 2026-04-14T16:29:10.016Z (about 2 months ago)
- Topics: ai, docker, homelab, image-editor, image-processing, open-source, self-hosted
- Language: TypeScript
- Homepage: https://ashim-hq.github.io/ashim/
- Size: 6.74 MB
- Stars: 697
- Watchers: 1
- Forks: 17
- Open Issues: 19
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
ashim
A Self Hosted Image Manipulator
## Key Features
- **45+ image tools** - Resize, crop, compress, convert, watermark, color adjust, vectorize, create GIFs, find duplicates, generate passport photos, and more
- **Local AI** - Remove backgrounds, upscale images, restore and colorize old photos, erase objects, blur faces, enhance faces, extract text (OCR). All on your hardware - no internet required
- **Pipelines** - Chain tools into reusable workflows. Batch process up to 200 images at once
- **REST API** - Every tool available via API with API key auth. Interactive docs 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
```bash
docker run -d --name ashim -p 1349:1349 -v ashim-data:/data ghcr.io/ashim-hq/ashim:latest
```
Open http://localhost:1349 in your browser.
Have an NVIDIA GPU? Click here for GPU acceleration.
Add `--gpus all` for GPU-accelerated background removal, upscaling, and OCR:
```bash
docker run -d --name ashim -p 1349:1349 --gpus all -v ashim-data:/data ghcr.io/ashim-hq/ashim:latest
```
> Requires an NVIDIA GPU and [Container Toolkit](https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/latest/install-guide.html). Falls back to CPU if no GPU is found. See [Docker Tags](https://ashim-hq.github.io/ashim/guide/docker-tags) for benchmarks and Docker Compose examples.
**Default credentials:**
| Field | Value |
|----------|---------|
| Username | `admin` |
| Password | `admin` |
You will be asked to change your password on first login.
For Docker Compose, persistent storage, and other setup options, see the [Getting Started Guide](https://ashim-hq.github.io/ashim/guide/getting-started). For GPU acceleration and tag details, see [Docker Tags](https://ashim-hq.github.io/ashim/guide/docker-tags).
## Documentation
- [Getting Started](https://ashim-hq.github.io/ashim/guide/getting-started)
- [Configuration](https://ashim-hq.github.io/ashim/guide/configuration)
- [REST API](https://ashim-hq.github.io/ashim/api/rest)
- [Architecture](https://ashim-hq.github.io/ashim/guide/architecture)
- [Developer Guide](https://ashim-hq.github.io/ashim/guide/developer)
- [Translation Guide](https://ashim-hq.github.io/ashim/guide/translations)
## Feedback
Found a bug or have a feature idea? Open a [GitHub Issue](https://github.com/ashim-hq/ashim/issues). We don't accept pull requests, but your feedback directly shapes the project. See [CONTRIBUTING.md](CONTRIBUTING.md) for details.
## License
This project is dual-licensed under the [AGPLv3](LICENSE) 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):** For use in proprietary software or SaaS products where AGPLv3 source-disclosure is not suitable, a commercial license is available. [Contact us](mailto:ashim.hq@gmail.com) for pricing and terms.