A Python FFI of nihui/waifu2x-ncnn-vulkan achieved with SWIG
Project description
waifu2x ncnn Vulkan Python
Introduction
A Python FFI of nihui/waifu2x-ncnn-vulkan achieved with SWIG.
waifu2x-ncnn-vulkan is nihui's ncnn implementation of waifu2x converter. Runs fast on Intel / AMD / Nvidia with Vulkan API.
This project only wrapped the original Waifu2x class. As a result, functions other than the core upscaling and denoising such as multi-thread loading and saving are not available. Of course, the auto tilesize and prepadding settings are implemented, so don't worry about them.
Download
linux x64, Windows x64 and MacOS x64 releases are available now. For other platforms, you may compile it on your own. The reason why MacOS ARM64 build is not available is that it needs ARM Python Dev Libs which I have no ideas on how to get it on Github's MacOS x64 VM. Moreover, I don't have a Mac.
However, for Linux (Like Ubuntu 18.04) with an older GLIBC (version < 2.29), you may try to use the ubuntu-1804 release or just compile it on your own.Windows release is not working for all python version. The version of Windows build is for python 3.9. This is a known issue: ImportError: DLL load failed while importing _rife_ncnn_vulkan_wrapper: The specified module could not be found.- Updates:
- The binary wheel releases on Github are now linked with specific python version. Please download the right one according to your python version.
- it has been uploaded to PyPI, and you can install it with pip now. But you need to have all the build dependencies (SWIG and Vulkan Dev) installed. Because the PYPI package of this lib is a source distribution.
Installation
pip install waifu2x-ncnn-vulkan-python
Build
First, you have to install python, python development package (Python native development libs in Visual Studio), vulkan SDK and SWIG on your platform. And then, there are two ways to build it:
- Use setuptools to build and install into python package directly. (Currently in developing)
- Use CMake directly (The old way)
Use setuptools
python setup.py install
Use CMake
Linux
- install dependencies: cmake, vulkan sdk, swig and python-dev
Debian, Ubuntu and other Debian-like Distros
apt-get install cmake libvulkan-dev swig python3-dev
Arch Distros
pacman -S base-devel cmake vulkan-headers vulkan-icd-loader swig python
- Build with CMake
git clone --recursive https://github.com/media2x/waifu2x-ncnn-vulkan-python.git
cd waifu2x-ncnn-vulkan-python
cmake -B build -S waifu2x_ncnn_vulkan_python
cmake --build build
Windows
I used Visual Studio 2019 and msvc v142 to build this project for Windows.
Install visual studio and open the project directory, and build. Job done.
One way is using Visual Studio to open the project as directory, and build it from Visual Studio. And another way is build it from powershell just like what is written in the release.yml
Mac OS X
- install dependencies: cmake, vulkan sdk, swig and python-dev
- download vulkan sdk from https://vulkan.lunarg.com/sdk/home
- If you have homebrew installed, run the command below to get SWIG
brew install swig
- I guess python dev is out-of-box in Mac. If not, google it.
- Build with CMake
- You can pass -DUSE_STATIC_MOLTENVK=ON option to avoid linking the vulkan loader library on MacOS
- The remaining steps are similar to Linux.
Usages
Example program
from PIL import Image
from waifu2x_ncnn_vulkan import Waifu2x
with Image.open("input.png") as image:
waifu2x = Waifu2x(gpuid=0, scale=2, noise=3)
image = waifu2x.process(image)
image.save("output.png")
Docs
Known issues
- Module finalization will crash for nvidia dedicated graphics card(s) on Linux. (The image processing still works.)
- Not yet tested for Mac OS. I guess it should work.
Software that uses this package
Original waifu2x Project
- https://github.com/nagadomi/waifu2x
- https://github.com/lltcggie/waifu2x-caffe
- https://github.com/nihui/waifu2x-ncnn-vulkan
Other Open-Source Code Used
- https://github.com/Tencent/ncnn for fast neural network inference on ALL PLATFORMS
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Hashes for waifu2x-ncnn-vulkan-python-1.0.4.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | bc7023cd4f2daf7ce3954086ef314f92236ca6529ad7715d1324291a1dfeda00 |
|
MD5 | 16fb7d47b867dafdf17e174a76a8fd04 |
|
BLAKE2b-256 | 4228a5ed9e1e843732709d07a0e1c8d50a71a1933a923883905aa4d11191b297 |