MCPcopy
hub / github.com/snapotter-hq/SnapOtter

github.com/snapotter-hq/SnapOtter @v1.17.2 sqlite

repository ↗ · DeepWiki ↗ · release v1.17.2 ↗
2,441 symbols 8,521 edges 860 files 316 documented · 13%
README

SnapOtter - A Self Hosted Image Manipulator

Docker Hub GHCR CI OpenSSF Best Practices License Stars Live Demo Discord Sponsor

SnapOtter - Dashboard

Key Features

  • 53 image tools: Resize, crop, compress, convert, watermark, color adjust, beautify screenshots, generate memes, vectorize, create GIFs, find duplicates, generate passport photos, and more. Supports 55+ input formats (including 23 camera RAW formats) and 14 output formats
  • Image editor: Layer-based editor with brushes, shapes, adjustments, filters, curves, and keyboard shortcuts. Runs in your browser, processes on your hardware
  • Local AI: Remove backgrounds, upscale images, restore and colorize old photos, erase objects, blur faces, enhance faces, extract text (OCR), expand canvas, fix transparency. All on your hardware, no internet required
  • OIDC / SSO: Login with Google, GitHub, Okta, or any OpenID Connect provider
  • 20 languages: Arabic, Chinese, Czech, Dutch, French, German, Hindi, Indonesian, Italian, Japanese, Korean, Polish, Portuguese, Russian, Spanish, Thai, Turkish, Ukrainian, Vietnamese. RTL support for Arabic
  • Pipelines: Chain tools into reusable workflows with unlimited steps. Import/export as JSON. Batch process unlimited 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)
  • Privacy first: Your images never leave your network. SnapOtter asks once whether you'd like to share anonymous product analytics (which tools are used, errors encountered, never file data). Change anytime in Settings, or set ANALYTICS_ENABLED=false to disable completely

Quick Start

docker run -d --name snapotter -p 1349:1349 -v snapotter-data:/data snapotter/snapotter:latest

Have an NVIDIA GPU? Click here for GPU acceleration.

Add --gpus all for GPU-accelerated background removal, upscaling, and OCR:

docker run -d --name snapotter -p 1349:1349 --gpus all -v snapotter-data:/data snapotter/snapotter:latest

Requires an NVIDIA GPU and Container Toolkit. Falls back to CPU if no GPU is found. See 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. For GPU acceleration and tag details, see Docker Tags.

Documentation

Contributing

We welcome bug reports, feature ideas, and pull requests. See CONTRIBUTING.md for the full guide, or jump in:

Support SnapOtter

SnapOtter is built and maintained independently with no venture capital or corporate backing. Sponsorships fund infrastructure, keep releases flowing, and ensure the project stays free and open for everyone.

If SnapOtter saves you from paying for cloud image services, consider supporting its development:

Sponsor SnapOtter on GitHub

Star History Chart

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.
  • 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 for pricing and terms.

Extension points exported contracts — how you extend this code

RedEyeRemovalOptions (Interface)
(no doc)
packages/ai/src/red-eye-removal.ts
SmartCropFacePreset (Interface)
(no doc)
packages/shared/src/constants.ts
LicensePayload (Interface)
(no doc)
packages/enterprise/src/license.ts
Operation (Interface)
(no doc)
packages/image-engine/src/engine.ts
LandingVideoProps (Interface)
(no doc)
apps/landing/src/components/landing-video.tsx
ParsedFile (Interface)
(no doc)
apps/api/src/routes/pipeline.ts
LineAttrs (Interface)
(no doc)
apps/web/src/types/editor.ts
ImgflipMeme (Interface)
(no doc)
scripts/fetch-meme-templates.ts

Core symbols most depended-on inside this repo

createMultipartPayload
called by 1644
tests/integration/test-server.ts
send
called by 613
apps/demo/src/mock-api.ts
uploadTestImage
called by 581
tests/e2e/helpers.ts
openSettings
called by 304
tests/e2e/helpers.ts
get
called by 194
scripts/generate-license.mjs
runPythonWithProgress
called by 160
packages/ai/src/bridge.ts
waitForProcessing
called by 160
tests/e2e/helpers.ts
cn
called by 139
apps/web/src/lib/utils.ts

Shape

Function 1,998
Interface 366
Method 51
Class 26

Languages

TypeScript92%
Python8%

Modules by API surface

docker/download_models.py30 symbols
packages/ai/python/install_feature.py29 symbols
apps/web/src/components/settings/settings-dialog.tsx29 symbols
apps/api/src/lib/feature-status.ts27 symbols
apps/web/src/lib/api.ts22 symbols
packages/image-engine/src/types.ts21 symbols
apps/web/src/components/tools/passport-photo-settings.tsx21 symbols
apps/web/src/components/tools/beautify-settings.tsx21 symbols
apps/api/src/lib/format-decoders.ts21 symbols
packages/ai/src/bridge.ts19 symbols
packages/ai/python/models/scunet_arch.py18 symbols
apps/web/src/types/editor.ts18 symbols

Dependencies from manifests, versioned

@aws-sdk/client-s33.1063.0 · 1×
@biomejs/biome2.4.16 · 1×
@dnd-kit/core6.3.1 · 1×
@dnd-kit/sortable10.0.0 · 1×
@dnd-kit/utilities3.2.2 · 1×
@fastify/cookie11.0.2 · 1×
@fastify/cors11.0.0 · 1×
@fastify/multipart9.0.0 · 1×
@fastify/rate-limit10.2.0 · 1×
@fastify/static8.1.0 · 1×
@neplex/vectorizer0.1.0 · 1×
@playwright/test1.60.0 · 1×

For agents

$ claude mcp add SnapOtter \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact