Ruah
On-device image tools for agents: cutouts, compress, resize, crop, upscale, EXIF removal
- Pricing
- Open source
- Platforms
- CLI, macOS, Windows
- Runs
- Locally
- Version
- 0.1.1
- Listing updated
- 3 days ago
About Ruah
Ruah is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.
Files stay on your computer. The server runs AI models and encoders locally, writing each result as a new file beside the original and returning its path with a small preview; existing files are never overwritten. Only model weights are downloaded, once, from Ruah's mirror, each checked against a pinned SHA-256 hash and cached in ~/.cache/ruah/models.
Background removal uses BiRefNet, with a lite 98 MB model fetched first and a larger one used only if no subject is found; upscaling uses Swin2SR at 2x or 4x. Compression, resizing, cropping and metadata removal need no download. Metadata removal strips EXIF (including GPS), XMP, IPTC and comments, and JPEG and PNG are cleaned without re-encoding.
It needs Node.js 20 or newer. Apple Silicon Macs are tested and use the GPU for upscaling; Linux and Windows use the CPU, and Intel Macs are not supported. HEIC input works only on macOS. The package is MIT licensed and is the engine behind the ruah.tools web app.
Install
Run in a terminal
claude mcp add ruah-mcp -- npx -y ruah-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"ruah-mcp": {
"command": "npx",
"args": [
"-y",
"ruah-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"ruah-mcp": {
"command": "npx",
"args": [
"-y",
"ruah-mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"ruah-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"ruah-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"ruah-mcp": {
"command": "npx",
"args": [
"-y",
"ruah-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"ruah-mcp": {
"command": "npx",
"args": [
"-y",
"ruah-mcp"
]
}
}
}Tools this server provides (6)
Taken from the project documentation; the running server may differ.
- remove_background
- Cuts the main subject out of a photo and saves a transparent PNG.
- compress
- Makes an image smaller or converts it to WebP, AVIF, JPEG or PNG.
- resize
- Changes pixel dimensions while keeping proportions.
- crop
- Crops to an aspect ratio or region, rotates by quarter turns and flips.
- upscale
- Enlarges an image 2x or 4x with AI super-resolution.
- strip_metadata
- Removes EXIF, XMP, IPTC, comments and embedded thumbnails.
What it does
- Background removal
- Cuts out the main subject and saves a transparent PNG.
- Compress and convert
- Shrinks images or converts to WebP, AVIF, JPEG or PNG.
- Resize and crop
- Resize by longest side or percent, or crop to a ratio or region without resampling.
- AI upscaling
- Enlarge 2x or 4x while keeping transparency.
- Metadata stripping
- Remove EXIF, XMP, IPTC, comments and embedded thumbnails.
- Non-destructive output
- Writes new files and never overwrites the original.
Good for
- Prepare product photos with transparent backgrounds
- Convert screenshots to WebP in a batch
- Strip GPS location from photos before sharing
- Upscale a small image by 2x or 4x
- Shrink image weight before a site release
Pricing
Open source
MIT licensed; the ruah.tools web app is free and unlimited
Prices change. Check ruah.tools before you buy.
Ruah FAQ
Do my images leave my computer?
No. Processing runs locally; only model weights are downloaded, once.
Which Node.js version is needed?
Node.js 20 or newer.
Does it work on Intel Macs?
No. The ONNX runtime it uses ships no build for them.
Can it read iPhone HEIC photos?
Only on macOS, because HEVC decoding is available only there.
What licence applies?
ruah-mcp is MIT licensed; the downloaded models keep their own licences (BiRefNet MIT, Swin2SR Apache-2.0).
Is Ruah free?
Yes. Ruah is open source, so you can use and self-host it for free.
How do I add Ruah to Claude Code?
Run this command in your terminal: claude mcp add ruah-mcp -- npx -y ruah-mcp
What are the best alternatives to Ruah?
The closest alternatives to Ruah are HyperFrames by HeyGen, ffmpeg-skill, ASTra, AvatarSay — Fictional Character & Talking Video MCP and ChartAnt.
Alternatives to Ruah

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

ffmpeg-skill
MCP serverLocal FFmpeg video and audio editing tools for coding agents over MCP
Runs locally- Open source
- 6.9K GitHub stars
- Design and media

ASTra
MCP serverLet agents read, edit, validate and undo Word .docx files with exact operations
Runs locally- 5 tools
- Freemium
- Files and documents

Generate fictional character portraits and lip-synced talking videos from text over MCP
- 10 tools
- Remote
- Freemium
- Design and media

ChartAnt
MCP serverRemote MCP server returning charts, maps and dashboards as hosted PNG links
- 51 tools
- Remote
- Freemium
- Design and media

VfxSmith
MCP serverSearch, generate, refine and export pixel art game effects from Claude Code or Codex
Not checked yet- Remote
- Freemium
- Design and media