Coder Social home page Coder Social logo

v2.11 is out! 🥳 Download v2.11! ⬇️



🆙 Upscayl

Free and Open Source AI Image Upscaler

Upscayl lets you enlarge and enhance low-resolution images using advanced AI algorithms. Enlarge images without losing quality. It's almost like magic! 🎩🪄

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

Screenshot

Important

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

👨‍💻 Installation

🐧 Linux

Upscayl should be available on the software listings of most Linux operating systems. Your distro's Store app might also support the Flatpak or Snap version.

💼 Portable Method

  1. Go to releases section
  2. Download the upscayl-x.x.x-linux.AppImage file.
  3. Right Click AppImage -> Go to Permissions tab -> Check 'allow file to execute' and then double click the file to run Upscayl.

You can also choose to install using other formats like RPM (Fedora), DEB (Debian/Ubuntu based), and ZIP (Any x86 Linux OS).

🍎 macOS

(MacOS 12 and later)

  1. Go to releases section
  2. Download the upscayl-x.x.x-mac.dmg file.
  3. Double click dmg, drag Upscayl icon into Applications folder.
  4. Open Finder, click 'Applications' tab in the left sidebar. Find Upscayl and right click on it. Select 'Open'.
  5. In the window that appears, press 'Open' yet again.

🍺 Homebrew

brew install --cask upscayl

🐌 Windows

(Windows 10 and later)

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

👨‍🏫 Documentation - Tutorials and Guides

Check out our Documentation 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.

🏃 Running

Note

If you are not willing to install git, you can skip the first line, download the source zip and extract it to upscayl instead and carry on with the rest of the instructions.

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 start

🏗️ Building

# INSTALL DEPENDENCIES
npm install

# PACKAGE THE APP
npm run dist

# PUBLISH THE APP, MAKE SURE TO ADD GH_TOKEN= IN SHELL
# ONLY DO THIS IF YOU'RE A MAINTAINER
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 Vulkan architecture to achieve this. Our backend is fully open-source under the AGPLv3 license.
  • I don't see a drastic change in my upscaled image. Why is that?
    • Upscayl can enhance low resolution images and images that are pixelated but it cannot de-blur or do focus adjustment on your image. If your image is out-of-focus or totally blurred, Upscayl is not the right tool for it. Please use images that are similar to the examples we've given here.
  • Is there a CLI available?
  • 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 ;)
      • @Wyrdgirn has contributed a workaround for Windows and Linux in #390! Nobody knows how to manipulate the macOS and Haiku frameworks...
  • I stopped the magic Batch Upscayl and my images haven't been processed, compressed, or are in the wrong scale!
    • When a model doesn't support an action, Upscayl will finish upscayling all the images first before post-processing them. What this means is that you should simply wait for the process to finish.
  • How can I contribute?
    • You can report issues, fix code and add features by submitting PRs, or donate! 😊
  • What's the GPU ID for?
    • It is for selecting which GPU to use. The specific procedure is detailed in the Wiki.
      • Note that for Windows systems, if Upscayl is not set to performance mode, the system may override this setting.
  • Where do I find more models?

🎁 Donate

❤ Credits

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

Upscayl's Projects

appimage.github.io icon appimage.github.io

Given an URL to an AppImage, the GitHub action in this project inspects the AppImage and puts it into a community-maintained catalog

flathub icon flathub

Pull requests for new applications to be added

real-esrgan icon real-esrgan

Real-ESRGAN aims at developing Practical Algorithms for General Image/Video Restoration.

snap icon snap

Snap Store package for Upscayl

upscayl icon upscayl

🆙 Upscayl - #1 Free and Open Source AI Image Upscaler for Linux, MacOS and Windows.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.