Cool_Tools/upscayl

Fork 0

mirror of https://github.com/upscayl/upscayl.git synced 2024-09-24 11:28:25 +02:00

NayamAmarshe 6e14c57213

Update README.md

2022-12-23 12:56:21 +05:30

7.9 KiB

Raw Blame History

Upscayl 🆙

Free and Open Source AI Image Upscaler

Upscayl is a cross-platform application built with the Linux-first philosophy. This means that we prioritize Linux builds over others but that doesn't mean we'll break things for other OSes :)

NOTE: You'll need a Vulkan compatible GPU to upscale images. Many CPU and iGPUs do not work but no harm in trying.

Installation 👨‍💻

Linux 🐧

Go to releases section
Download the .AppImage file.
Right Click AppImage -> Go to Permissions tab -> Check allow file to execute and then double click the file to run Upscayl.

You can also download the flatpak version and double click the flatpak file to install via Store but wait for the full release, we'll be pushing it to Flathub for easy access.

MacOS 🍎

Go to releases section
Download the .dmg file.
Double click dmg, drag Upscayl icon into Applications folder.

Windows 🐌

Go to releases section
Download the .exe file.
Double click exe file, wait for installation, profit.

Comparisons:

Medium Resolution Images (300-400 pixels wide):

Low Resolution Images (150 pixels wide):

Super Low Resolution Images (75 pixels wide):

UPSCALED TWICE

Roadmap 🤫

More AI models (Added ✅)
Allow video upscaling 📼
Make the whole world use FOSS (WIP 🚧)

Development 🛠

git clone https://github.com/TGS963/upscayl
cd upscayl

# INSTALL DEPENDENCIES
npm install

# RUN THE DEVELOPMENT SERVER LOCALLY
npm run start

# PACKAGE THE APP
npm run dist

# PUBLISH THE APP, MAKE SURE TO ADD GH_TOKEN= IN SHELL
npm run publish-app

FAQ 🤓

How does Upscayl work?
- Upscayl uses AI models to enhance your images by guessing what the details could be. It uses Real-ESRGAN (and more in the future) model to achieve this.
Is there a CLI available?
- The CLI tool is called real-esrgan-ncnn-vulkan and it's available on the Real-ESRGAN repository.
Do I need a GPU for this to work?
- Yes, unfortunately. NCNN Vulkan requires a Vulkan compatible GPU. Upscayl won't work on most iGPUs or CPUs.
How can I contribute?
- You can donate more NCNN compatible models or fix code by submitting PRs :)
You are not fully open source!!😡
- We are, we're using completely free and open source tech. We do ship a binary but that's because not including it would kill the entire purpose of the project. If you want to deal with all those PyTorch, NCNN, and Python errors, you're more than welcome to compile your own binary using the code provided by Real-ESRGAN. The binary is pre-compiled for convenience, if you do not trust it, then you can compile your own since everything is free and open source here :)

Upscayl uses Real-ESRGAN-ncnn-vulkan binaries to upscale images. More models and algorithms will come soon.

Donate

Credits ❤

Real-ESRGAN for their wonderful research work.
Real-ESRGAN: Copyright (c) 2021, Xintao Wang
Microsoft™ for their Fluent Emoji used as our logo.
@JanDeDinoMan, @xanderfrangos, @Fdawgs, @keturn for their code contributions :)
@aaronliu0130 for providing community support :)

7.9 KiB Raw Blame History