Final2x
[](https://github.com/EutropicAI/Final2x/actions/workflows/CI-test.yml)
[](https://github.com/EutropicAI/Final2x/actions/workflows/CI-test-core.yml)
[](https://github.com/EutropicAI/Final2x/actions/workflows/CI-build.yml)
[](https://github.com/EutropicAI/Final2x/actions/workflows/Release.yml)
A cross-platform image super-resolution tool for Windows, macOS, and Linux.
Use built-in models or load your own. See the [custom model demo](https://github.com/EutropicAI/cccv_demo_remote_model) to get started.
## 🖼️ Screenshots
## 📦 Installation
[Download the latest release](https://github.com/EutropicAI/Final2x/releases) for your platform.
### 🪟 Windows
Install from the release page, or use a package manager such as winget or Scoop. Package manager versions may lag behind the latest release.
### 🍎 macOS
If macOS blocks the app on first launch, run the following command in Terminal after placing it in `/Applications`:
```bash
xattr -cr /Applications/Final2x.app
```
### 🐧 Linux
Install Python >= 3.10 and PyTorch >= 2.0, then install the backend and required system libraries. On Debian or Ubuntu:
```bash
pip install Final2x-core
Final2x-core -h # Verify the backend installation
sudo apt install -y libomp5 xdg-utils
```
## 🧩 References
The Python CLI and desktop backend live in [`core`](./core) and share the desktop app's version number.
This project builds on the following open-source projects:
- [cccv](https://github.com/EutropicAI/cccv) — image restoration and super-resolution backend
- [naive-ui](https://github.com/tusen-ai/naive-ui)
- [electron-vite](https://github.com/alex8088/electron-vite)
## 📄 License
This project is licensed under the BSD 3-Clause - see
the [LICENSE file](./LICENSE) for details.
## 💙 Acknowledgements
Feel free to reach out to the project maintainers with any questions or concerns~