Cool_Tools/upscayl
1
0
Fork 0
mirror of https://github.com/upscayl/upscayl.git synced 2024-11-12 01:40:53 +01:00
Code Releases Wiki Activity
03f6df53d2
upscayl/README.md
Danik1601 03f6df53d2
Merge branch 'main' into main
2023-05-11 13:46:17 +03:00

9.6 KiB
Raw Blame History

v2.5 is out! Upscayl hits 1 million downloads!



🆙 Upscayl

Free and Open Source AI Image Upscaler

Upscayl is a cross-platform application built with the Linux-first philosophy.
This means that Linux users receive pre-release builds earlier but Upscayl itself is available on all major desktop operating systems :)
https://upscayl.org

216shots_so

- 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

Flatpak

  1. Go to Flathub/Upscayl

  2. Press the "Install" button. This will download the .flatpakref file.

  3. Execute the downloaded .flatpakref file. This will open your disrtibution's software center.

  4. Press the installation button in your disrtibution's software center.

Please note:

AppImage

  1. Go to releases section

  2. Download the .AppImage file.

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

Please note:

🍎 MacOS

  1. Go to releases section

  2. Download the .dmg file.

  3. Double click dmg, drag Upscayl icon into Applications folder.

If you encounter an error with opening the application, try Ctrl+Clicking/Right-clicking the app and clicking open. In the popup that opens, also click open.

🐌 Windows

  1. Go to releases section

  2. Download the .exe file.

  3. Double click exe file, wait for installation, profit.

👨‍🏫 Wiki - Tutorials and Guides

Check out our Wiki here.

⚖️ Results

Check out Upscayl before/after comparisons here.

🤫 Roadmap

You can track all the progress here: https://github.com/orgs/upscayl/projects/1

  • Fix bugs
  • Make the whole world use FOSS (WIP 🚧)

🛠 Development

I recommend using Volta: https://volta.sh for installing Node.js. Download and install volta, then do: volta install node.

# FOR EVERYONE
git clone https://github.com/upscayl/upscayl
cd upscayl

# INSTALL DEPENDENCIES
npm install

# RUN THE DEVELOPMENT SERVER LOCALLY
## YOUR LOGS WILL NOW APPEAR IN THE TERMINAL
npm run dev

# FOR DEVS
## 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 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 with most iGPUs or CPUs. But hey, no harm in trying ;)
  • Why does batch upscaling output JPGs instead of PNGs?
    • This is an issue with REAL-ERSGAN currently tracked here.
  • How can I contribute?
    • You can fix code, add features by submitting PRs, report issues or donate :)
  • What's the GPU ID for?
    • Read the Wiki.
  • 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

Copyright © 2023 - Upscayl
By Nayam Amarshe and TGS963
Made with 🖱 & ⌨