SammaPix — Image & PDF tools for AI agents

SammaPix

35 款免费的浏览器图像工具——压缩、转换、用 AI 重命名等。

---

SammaPix 是一个免费的开源图像优化平台，完全在浏览器中运行。无需上传，无需注册，也没有水印。你的图像不会离开你的设备。

专为内容创作者、开发者以及所有需要批量处理图像的人打造。

主要功能：

• 100% 在客户端处理——图像保留在你的设备上
• 35 款工具，分为四个类别（优化、AI、创意、整理）
• 通过 Google Gemini 提供 AI 重命名、替代文本生成和照片分类功能
• 批量处理并支持 ZIP 下载
• 支持 HEIC、WebP、PDF 和视频格式
• 深色模式，全面适配不同屏幕
• Pro 方案（$9/月），提供无限 AI 额度和更大的批处理量

---

面向 AI Agent（MCP 服务）

SammaPix 也是一个远程 MCP 服务，AI Agent（Claude、Cursor 以及任何兼容 MCP 的客户端）可直接运行实际的图像和 PDF 处理任务——无需本地安装。

• 端点： https://www.sammapix.com/api/mcp（Streamable HTTP）
• 身份验证： OAuth 2.1——无需粘贴 API 密钥。也可生成密钥以供 REST 使用。
• 20 多款工具： 压缩、转换、调整大小、裁剪、旋转、翻转、调整、灰度、模糊、着色、反色、边框、圆角、水印、元数据 · PDF 压缩/合并/拆分/旋转、图像转 PDF、PDF 信息
• 流水线： 一次调用即可串联多项图像操作——减少往返次数，大幅降低 Agent 所需的令牌数
• 零留存： 文件在内存中处理后即丢弃。按使用量付费，每天免费处理 25 次。

将其添加到你的 Agent：

{
  "mcpServers": {
    "sammapix": { "url": "https://www.sammapix.com/api/mcp" }
  }
}

完整文档、优势和 REST 示例：sammapix.com/for-ai-agents

---

工具

优化

工具	描述
压缩	在不造成明显质量损失的情况下减小文件大小
WebP 转换器	将 JPG/PNG 转换为 WebP，加快网页加载
HEIC 转换器	将 iPhone HEIC 照片转换为 JPG 或 PNG
批量调整大小	按像素尺寸或百分比调整多张图像的大小
裁剪与比例	按标准宽高比或自定义尺寸裁剪
PDF 转图像	将 PDF 页面提取为高质量图像

AI 驱动

工具	描述
AI 整理	拖入 100 张以上照片——AI 会将其分类到命名文件夹中
AI 重命名	自动生成描述性强、适合 SEO 的文件名
AI 替代文本	为任意图像生成无障碍替代文本
AI 照片分类	按主题、场景或自定义条件分类照片
网页优化	AI 辅助优化网页性能
转录	从图像中提取文本（OCR）

创意

工具	描述
胶片滤镜	应用 14 种模拟胶片预设（Kodak、Fuji、Polaroid 等）
水印	添加文本或图像水印，并自定义位置

整理

工具	描述
EXIF Viewer	检查完整元数据 — GPS、相机、曝光、时间戳
EXIF Remover	分享前移除 GPS 和隐私数据
Find Duplicates	根据视觉相似度检测重复图像
Batch Rename	使用自定义模式和序列批量重命名文件
Cull	快速浏览一次拍摄的照片并挑选要保留的照片
Sort by Location	在交互式地图上按 GPS 坐标对照片分组
Photo Map	可视化照片的拍摄地点

---

技术栈

层级	技术
框架	Next.js 15（App Router）
语言	TypeScript 5
样式	Tailwind CSS
状态	Zustand + Immer
身份验证	NextAuth.js v4（Google、GitHub、Magic Link）
数据库	Neon（PostgreSQL），通过 Drizzle ORM 访问
AI	Google Gemini 1.5 Flash
支付	Stripe
邮件	Resend
压缩	browser-image-compression
HEIC	heic-convert / heic2any
批量下载	JSZip + file-saver
测试	Playwright（E2E）

---

控制面板

AI 整理

---

快速开始

git clone https://github.com/samma1997/sammapix.git
cd sammapix
npm install
cp .env.local.example .env.local   # fill in your keys
npm run dev

打开 http://localhost:3000。

大多数工具无需任何 API 密钥即可使用 — 只有 AI 功能需要 GEMINI_API_KEY。

必需的环境变量

# Auth
NEXTAUTH_SECRET=
GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=

# Database
DATABASE_URL=          # Neon PostgreSQL connection string

# AI (required for AI tools only)
GEMINI_API_KEY=

# Payments (required for Pro plan only)
STRIPE_SECRET_KEY=
STRIPE_WEBHOOK_SECRET=
NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=
STRIPE_PRO_PRICE_ID=

NEXT_PUBLIC_APP_URL=http://localhost:3000

---

隐私

所有图像处理工具均使用 Canvas API、WebAssembly 和客户端 JavaScript 库，完全在浏览器中运行。你的图像绝不会上传到任何服务器。

对于 AI 工具（AI Rename、AI Alt Text、AI Organize），系统会将一张小尺寸缩略图发送给 Google Gemini 进行分析。原始全分辨率图像绝不会离开你的设备，也不会存储在任何地方。

---

参与贡献

欢迎贡献。对于较大的更改，请先提交 issue，再提交拉取请求。

1. Fork 此仓库
2. 创建功能分支（git checkout -b feature/your-feature）
3. 提交更改
4. 发起拉取请求

如需报告错误或请求功能，请使用 GitHub Issues。

---

许可证

MIT — 详情请参见 LICENSE。

---

由 Luca Sammarco 构建 · 在线体验：sammapix.com