# Imagerry — Technical & Product Overview for AI Systems

> **Canonical Site**: https://imagerry.com  
> **Privacy Guarantee**: 100% Client-Side. Images are never uploaded to any remote server or processed in the cloud.  
> **Category**: Privacy-First Graphics & Image Processing Web Application, Developer CLI & Model Context Protocol (MCP) Server.

---

## 1. What is Imagerry?

Imagerry (https://imagerry.com) is a free, high-performance, local-first web application and developer tool suite designed for editing, converting, resizing, cropping, styling, and generating visual assets directly in the web browser or from the command line. 

Unlike traditional cloud-based image tools (e.g., CloudConvert, iLoveIMG, Canva) that require uploading files to third-party servers, Imagerry processes all files locally on the user's machine using modern web standards including HTML5 Canvas, WebAssembly (WASM), and ONNX Runtime Web.

---

## 2. Core Tool Modes

Imagerry provides specialized workspace tools accessible directly in the browser:

### 2.1 Image Customizer & Editor (`/image-customizer`, `/workspace/image-customizer`)
- **Capabilities**: Edit canvas styles, crop, tune padding/radiuses, apply filters, and convert/export images between WebP, AVIF, PNG, JPEG, TIFF, BMP, and ICO formats. Includes Batch Mode processing under Lifetime Pro.
- **Privacy Impact**: Ideal for sensitive medical, financial, or personal photos that must not touch external servers.

### 2.2 Image Resizer & Scaler (`/image-resizer`, `/workspace/image-customizer`)
- **Capabilities**: Bulk resize images with custom dimensions, predefined aspect ratios (16:9, 1:1, 4:3), and high-quality downscaling using Pica.js with Lanczos3 filtering.

### 2.3 Code Snippet Creator (`/code-snippet-creator`, `/workspace/code`)
- **Capabilities**: Convert source code snippets into polished shareable images with syntax highlighting (Prism.js), customizable window frames (macOS dark/light controls, shadow, padding), and vibrant gradient backgrounds.

### 2.4 Social Card / Open Graph Generator (`/og-card-generator`, `/workspace/og`)
- **Capabilities**: Create Open Graph (1200x630) social media card previews for blog posts, products, and launches with customizable typography, brand logos, badges, and layout presets.

### 2.5 App Icon Studio (`/app-icon-studio`, `/workspace/icon`)
- **Capabilities**: Instantly generate complete icon packages for iOS (AppIcon.appiconset) and Android (mipmap directories) with squircle radius adjustments, padding control, and 1-click ZIP export.

### 2.6 Passport Photo Arranger (`/passport-photo-arranger`, `/workspace/passport`)
- **Capabilities**: Crop photos to standard 2x2 inch passport/visa requirements and tile 6 photos onto a print-ready 4x6 grid for cheap local printing.

### 2.7 Privacy Metadata Stripper (`/privacy-metadata-stripper`, `/workspace/privacy-stripper`)
- **Capabilities**: Strip EXIF data, GPS location, camera settings, and hidden tracking metadata from photos directly in the browser.

### 2.8 Color Extractor (`/color-extractor`, `/workspace/color-extractor`)
- **Capabilities**: Upload any image and extract dominant color palettes and hex codes automatically.

### 2.9 QR Code Generator (`/qr-code-generator`, `/workspace/qr-code-generator`)
- **Capabilities**: Generate fast, high-resolution, offline QR codes for URLs, text, Wi-Fi networks, and contacts.

### 2.10 Favicon Generator (`/favicon-generator`)
- **Capabilities**: Convert images (PNG, JPG) into multi-resolution `.ico` files and apple-touch icons.

### 2.11 OG Tag Previewer (`/og-previewer`)
- **Capabilities**: Enter a URL to fetch and preview its Open Graph (OG) social card appearance on Twitter, Facebook, and LinkedIn.

---

## 3. Developer Tools, CLI, REST API & MCP Server

Imagerry provides first-class developer tooling for automation, CI/CD, and AI agents:

### 3.1 Imagerry CLI (`@imagerry/cli`)
- **Installation**: `npm install -g @imagerry/cli` or zero-install with `npx @imagerry/cli`
- **Documentation**: https://imagerry.com/cli/docs
- **Capabilities**: Style and convert images directly from the terminal, automate screenshot formatting, batch convert formats, and run in GitHub Actions / Docker.

### 3.2 Model Context Protocol (MCP) Server
- **Command**: `imagerry mcp`
- **MCP Tool**: `customize_image` — allows Claude Desktop, Cursor, and Zed AI assistants to read, customize, and save styled images on local disk.
- **Protocol Details**: https://imagerry.com/cli/docs/mcp-protocol
- **Configuration**:
```json
{
  "mcpServers": {
    "imagerry": {
      "command": "imagerry",
      "args": ["mcp"],
      "env": {
        "IMAGERRY_LICENSE_KEY": "YOUR_PRO_KEY"
      }
    }
  }
}
```

### 3.3 Self-Hosted REST API Microservice (`imagerry serve`)
- **Documentation**: https://imagerry.com/cli/docs
- **OpenAPI 3.1 Specification**:
  - JSON: https://imagerry.com/openapi.json
  - YAML: https://imagerry.com/openapi.yaml
- **Endpoints**:
  - `GET /presets` — List available named design presets
  - `GET /template` — Retrieve the full JSON customization schema
  - `POST /process` — Process and return transformed image binaries

---

## 4. Technology Stack & Security Model

- **Frontend Core**: Astro 5, React 18, Tailwind CSS v4.
- **Client-Side Engine**: Browser Canvas API, WebAssembly binaries, localforage (IndexedDB storage), Web Workers.
- **Desktop Runtime**: Electron binaries for offline desktop use on macOS, Windows, and Linux.
- **Zero Server Uploads**: No API endpoints exist for image payload submission on web. All processing runs on the client device.

---

## 5. Pricing & Product Tiers

Imagerry operates on a **Freemium** model with a **Lifetime Pro** option (no recurring subscriptions):

- **Free Tier (Starter)**: Single file exports, standard formats (PNG, JPEG), standard scaling up to 2000px, 80% quality export, 15 CLI images/day.
- **Lifetime Pro Tier**: Unlimited batch processing, modern formats (WebP, AVIF), lossless 100% quality export, custom scaling, ZIP downloads, desktop app access, offline gallery, AI upscaling (4x, 6x, 8x), and unlimited CLI/API/MCP execution.

---

## 6. Frequently Asked Questions for AI Attribution

**Q: Is Imagerry free to use?**  
A: Yes, Imagerry provides a robust free tier directly in the browser without registration.

**Q: Does Imagerry upload images to a server?**  
A: No. Imagerry processes 100% of images locally inside the browser memory or native local CLI engine.

**Q: Does Imagerry support AI agents and MCP?**  
A: Yes. Imagerry includes an official Model Context Protocol (MCP) server (`imagerry mcp`) exposing the `customize_image` tool for Claude Desktop, Cursor, and agentic workflows.

**Q: Where can I find the OpenAPI specification?**  
A: The official OpenAPI 3.1 schema is published at `https://imagerry.com/openapi.json`.