Upres Cli

UpRes MCP: list models, credits, submit 4K image and video upscale jobs.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

One-click editor setup isn’t available for this listing yet — we don’t have a confirmed install command, and we’d rather show nothing than point your editor at the wrong package or host. Follow the project’s own setup instructions, linked above.

Manual Client & Custom JSON ConfigExpand JSON ▾

No confirmed setup config for this listing yet. We only publish a config block when the install details come from the project itself — its README, its docs, or a verified owner. We haven’t found those for upres-cli, and we’d rather show nothing than a guess you’d paste into your client. Follow the project’s own setup instructions for the current steps.

Documentation Overview

upres-cli

Star this repo if UpRes helps you.

Official CLI + SDK for upres.ai — image, video, and speech restoration. One API, 14 public aliases, up to 8K output.

Code

$ upres upscale photo.jpg --model flare --scale 4
Submitting job... model=flare
Job created: 550e8400-e29b-41d4-a716-446655440000 (status: pending)
Waiting for result.......
Downloading to photo_upscaled.jpg... done.

Result: photo_upscaled.jpg

Why we built this

Topaz is $200/yr, desktop-only, no API, no automation
Upscayl is great for one-offs but can't handle bulk exports or CI pipelines
Every other SaaS upscaler either watermarks your output, caps resolution at 2K, or charges per image with no monthly plan

upres.ai gives you a clean REST API, 14 public aliases, batch processing, and predictable pricing starting at $9/mo on the Creator launch deal.

Quickstart

Node.js

Terminal

npx upres-cli upscale photo.jpg

Or install globally:

Terminal

npm install -g upres-cli
upres upscale photo.jpg --model lumen --scale 8 --output photo_8k.jpg

Python

Terminal

pip install upres-ai
upres upscale photo.jpg --model flare --scale 4

Authentication

Sign up at upres.ai (free — 5 upscales/month)
Go to upres.ai/account/api-keys
Generate a key — it's shown once

server.ts

export UPRES_API_KEY=upres_yourkey

Or save permanently:

bash

mkdir -p ~/.config/upres
echo '{"apiKey":"upres_yourkey"}' > ~/.config/upres/config.json

Key resolution order: --api-key flag → UPRES_API_KEY env var → ~/.config/upres/config.json

Commands

bash

# Upscale a single image (local file or URL)
upres upscale photo.jpg --model flare --scale 4
upres upscale photo.jpg --model lumen --scale 8 --output out.jpg
upres upscale https://example.com/photo.jpg --model prism

# Upscale video (AI-generated video from Sora, Kling, Runway etc.)
upres upscale clip.mp4 --model motion --scale 4

# Batch upscale a folder
upres batch ./photos/ --model flare --output ./upscaled/ --concurrency 5

# List available models
upres models

# List recent jobs
upres jobs --limit 20 --status completed

# Account / quota info
upres account

Node.js SDK

server.ts

import { UpresClient } from "upres-cli";

const client = new UpresClient(); // reads UPRES_API_KEY from env

// Upscale a local file
const job = await client.createJobFromFile("photo.jpg", {
  model: "flare",
  scale: 4,
});

// Wait for completion
const completed = await client.waitForJob(job.id);

// Download result
await client.downloadResult(completed, "photo_4k.jpg");
console.log("Done:", completed.result_url);

Files over 50 MB are automatically uploaded via TUS resumable protocol.

Python SDK

server.ts

from upres import UpresClient

with UpresClient() as client:                        # reads UPRES_API_KEY from env
    job = client.create_job_from_file(
        "photo.jpg",
        model="flare",
        scale=4,
    )
    completed = client.wait_for_job(job["id"])
    client.download_result(completed, "photo_4k.jpg")
    print("Done:", completed["result_url"])

The Python SDK uses httpx — async-ready, no heavy dependencies.

Examples

Example	What it does
batch-upscale-folder.js	Upscale all images in a folder with configurable concurrency
restore-photo-folder.py	Restore old/scanned photos with Lumen
ecommerce-pipeline.js	Product image pipeline: raw shots → 4K → publish-ready
lightroom-export-hook.md	Auto-upscale Lightroom exports via post-processing hook
figma-plugin-stub.md	Figma plugin integration guide

Models

14 public aliases across image, video, and speech. Each one tells you up front whether it invents detail or leaves your file alone. Aliases that do not enlarge ignore --scale.

Alias	Kind	Best for
`flare`	Image	Everyday photos, fastest default
`prism`	Image	Text, logos, product shots — keeps edges true
`lumen`	Image	Maximum detail recovery for print, up to 8x
`mirage`	Image	Invents new detail — art and hero images
`hush`	Image	Faithful denoise, same size as the source
`keen`	Image	Deblur and sharpen, same size
`visage`	Image	Faces only, does not enlarge
`atelier`	Image	Hush, Visage if a portrait, then Lumen
`motion`	Video	Fast 4K finish for AI video
`motion-x`	Video	Cinema-grade, for film and commercials
`still`	Video	Temporal denoise, resolution stays put
`cadence`	Video	Frame interpolation, does not enlarge
`atelier-x`	Video	Still, then Motion X
`voice`	Speech	Speech denoise to 48 kHz. Not for music

Full model catalogue: upres.ai/models · Live spec: api.upres.ai/v1/openapi.json

Pricing

Plan	Price	Includes	API	Watermark
Free	$0	5 upscales/mo	—	Yes
Creator	$9/mo	50 stills + 20 min 4K video/mo	—	No
Studio	$39/mo	250 stills + 90 min 4K video/mo	Yes	No

Studio tier unlocks the full API, batch processing, and no output watermark.

Compare plans → · vs. Topaz → · vs. Upscayl →

MCP (Claude, Cursor, Hermes)

Terminal

claude mcp add upres -- npx -y github:auroracapital/upres-cli mcp

Or in claude_desktop_config.json / Cursor:

config.json

{
  "mcpServers": {
    "upres": {
      "command": "npx",
      "args": ["-y", "github:auroracapital/upres-cli", "mcp"],
      "env": { "UPRES_API_KEY": "upres_yourkey" }
    }
  }
}

Tools: upres_list_models, upres_get_credits, upres_upscale_image, upres_upscale_video, upres_enhance_audio, upres_get_job.

Free tier for open-source projects

If you're building something open-source on top of the API, email support@upres.ai with your repo link. We offer 500 ops/month for qualifying OSS projects.

Error handling

The SDK handles these errors automatically:

Status	Behavior
`401`	Prints API key error + link to key management, exits
`402`	Prints quota exceeded + link to pricing, exits
`429`	Prints rate limit message (60 req/min), exits
`5xx`	Throws `UpresError` with message

In Python: raises AuthError, QuotaExceededError, or UpresError.

Contributing

See CONTRIBUTING.md. Tests run with:

bash

# Node
npm test

# Python
pip install -e ".[dev]"
pytest tests/test_client.py -v

License

MIT — see LICENSE

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Upres Cli

We don't have a confirmed install command for upres-cli yet, so we don't publish a generated one — a guessed package name would point at the wrong package or none at all. Follow the project's own README or setup instructions (https://github.com/auroracapital/upres-cli.git) for the current steps.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/upres-cli?style=directory)](https://allmcps.com/mcp/upres-cli)

HTML Embed

<a href="https://allmcps.com/mcp/upres-cli"><img src="https://allmcps.com/api/badge/upres-cli?style=directory" alt="Upres Cli on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

27Quality signal: Emerging · 27/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership8/20

Documentation & tools11/30

Adoption & activity1/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge and attach your website — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Upres Cli →Install in Claude Desktop Install in Cursor Install in VS Code Setup guides for all 13 MCP clients

Upres Cli

UpRes MCP: list models, credits, submit 4K image and video upscale jobs.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Manual Client & Custom JSON ConfigExpand JSON ▾

Documentation Overview

upres-cli

Star this repo if UpRes helps you.

Official CLI + SDK for upres.ai — image, video, and speech restoration. One API, 14 public aliases, up to 8K output.

Code

$ upres upscale photo.jpg --model flare --scale 4
Submitting job... model=flare
Job created: 550e8400-e29b-41d4-a716-446655440000 (status: pending)
Waiting for result.......
Downloading to photo_upscaled.jpg... done.

Result: photo_upscaled.jpg

Why we built this

Topaz is $200/yr, desktop-only, no API, no automation
Upscayl is great for one-offs but can't handle bulk exports or CI pipelines
Every other SaaS upscaler either watermarks your output, caps resolution at 2K, or charges per image with no monthly plan

upres.ai gives you a clean REST API, 14 public aliases, batch processing, and predictable pricing starting at $9/mo on the Creator launch deal.

Quickstart

Node.js

Terminal

npx upres-cli upscale photo.jpg

Or install globally:

Terminal

npm install -g upres-cli
upres upscale photo.jpg --model lumen --scale 8 --output photo_8k.jpg

Python

Terminal

pip install upres-ai
upres upscale photo.jpg --model flare --scale 4

Authentication

Sign up at upres.ai (free — 5 upscales/month)
Go to upres.ai/account/api-keys
Generate a key — it's shown once

server.ts

export UPRES_API_KEY=upres_yourkey

Or save permanently:

bash

mkdir -p ~/.config/upres
echo '{"apiKey":"upres_yourkey"}' > ~/.config/upres/config.json

Key resolution order: --api-key flag → UPRES_API_KEY env var → ~/.config/upres/config.json

Commands

bash

# Upscale a single image (local file or URL)
upres upscale photo.jpg --model flare --scale 4
upres upscale photo.jpg --model lumen --scale 8 --output out.jpg
upres upscale https://example.com/photo.jpg --model prism

# Upscale video (AI-generated video from Sora, Kling, Runway etc.)
upres upscale clip.mp4 --model motion --scale 4

# Batch upscale a folder
upres batch ./photos/ --model flare --output ./upscaled/ --concurrency 5

# List available models
upres models

# List recent jobs
upres jobs --limit 20 --status completed

# Account / quota info
upres account

Node.js SDK

server.ts

import { UpresClient } from "upres-cli";

const client = new UpresClient(); // reads UPRES_API_KEY from env

// Upscale a local file
const job = await client.createJobFromFile("photo.jpg", {
  model: "flare",
  scale: 4,
});

// Wait for completion
const completed = await client.waitForJob(job.id);

// Download result
await client.downloadResult(completed, "photo_4k.jpg");
console.log("Done:", completed.result_url);

Files over 50 MB are automatically uploaded via TUS resumable protocol.

Python SDK

server.ts

from upres import UpresClient

with UpresClient() as client:                        # reads UPRES_API_KEY from env
    job = client.create_job_from_file(
        "photo.jpg",
        model="flare",
        scale=4,
    )
    completed = client.wait_for_job(job["id"])
    client.download_result(completed, "photo_4k.jpg")
    print("Done:", completed["result_url"])

The Python SDK uses httpx — async-ready, no heavy dependencies.

Examples

Example	What it does
batch-upscale-folder.js	Upscale all images in a folder with configurable concurrency
restore-photo-folder.py	Restore old/scanned photos with Lumen
ecommerce-pipeline.js	Product image pipeline: raw shots → 4K → publish-ready
lightroom-export-hook.md	Auto-upscale Lightroom exports via post-processing hook
figma-plugin-stub.md	Figma plugin integration guide

Models

14 public aliases across image, video, and speech. Each one tells you up front whether it invents detail or leaves your file alone. Aliases that do not enlarge ignore --scale.

Alias	Kind	Best for
`flare`	Image	Everyday photos, fastest default
`prism`	Image	Text, logos, product shots — keeps edges true
`lumen`	Image	Maximum detail recovery for print, up to 8x
`mirage`	Image	Invents new detail — art and hero images
`hush`	Image	Faithful denoise, same size as the source
`keen`	Image	Deblur and sharpen, same size
`visage`	Image	Faces only, does not enlarge
`atelier`	Image	Hush, Visage if a portrait, then Lumen
`motion`	Video	Fast 4K finish for AI video
`motion-x`	Video	Cinema-grade, for film and commercials
`still`	Video	Temporal denoise, resolution stays put
`cadence`	Video	Frame interpolation, does not enlarge
`atelier-x`	Video	Still, then Motion X
`voice`	Speech	Speech denoise to 48 kHz. Not for music

Full model catalogue: upres.ai/models · Live spec: api.upres.ai/v1/openapi.json

Pricing

Plan	Price	Includes	API	Watermark
Free	$0	5 upscales/mo	—	Yes
Creator	$9/mo	50 stills + 20 min 4K video/mo	—	No
Studio	$39/mo	250 stills + 90 min 4K video/mo	Yes	No

Studio tier unlocks the full API, batch processing, and no output watermark.

Compare plans → · vs. Topaz → · vs. Upscayl →

MCP (Claude, Cursor, Hermes)

Terminal

claude mcp add upres -- npx -y github:auroracapital/upres-cli mcp

Or in claude_desktop_config.json / Cursor:

config.json

{
  "mcpServers": {
    "upres": {
      "command": "npx",
      "args": ["-y", "github:auroracapital/upres-cli", "mcp"],
      "env": { "UPRES_API_KEY": "upres_yourkey" }
    }
  }
}

Tools: upres_list_models, upres_get_credits, upres_upscale_image, upres_upscale_video, upres_enhance_audio, upres_get_job.

Free tier for open-source projects

If you're building something open-source on top of the API, email support@upres.ai with your repo link. We offer 500 ops/month for qualifying OSS projects.

Error handling

The SDK handles these errors automatically:

Status	Behavior
`401`	Prints API key error + link to key management, exits
`402`	Prints quota exceeded + link to pricing, exits
`429`	Prints rate limit message (60 req/min), exits
`5xx`	Throws `UpresError` with message

In Python: raises AuthError, QuotaExceededError, or UpresError.

Contributing

See CONTRIBUTING.md. Tests run with:

bash

# Node
npm test

# Python
pip install -e ".[dev]"
pytest tests/test_client.py -v

License

MIT — see LICENSE

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Upres Cli

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/upres-cli?style=directory)](https://allmcps.com/mcp/upres-cli)

HTML Embed

<a href="https://allmcps.com/mcp/upres-cli"><img src="https://allmcps.com/api/badge/upres-cli?style=directory" alt="Upres Cli on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

27Quality signal: Emerging · 27/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership8/20

Documentation & tools11/30

Adoption & activity1/15

Community engagement0/10

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Upres Cli →Install in Claude Desktop Install in Cursor Install in VS Code Setup guides for all 13 MCP clients