auroracapital/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.
---
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
Or install globally:
Python
---
Authentication
1. Sign up at upres.ai (free — 5 upscales/month)
2. Go to upres.ai/account/api-keys
3. Generate a key — it's shown once
Or save permanently:
Key resolution order: --api-key flag → UPRES_API_KEY env var → ~/.config/upres/config.json
---
Commands
---
Node.js SDK
Files over 50 MB are automatically uploaded via TUS resumable protocol.
---
Python SDK
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 |