Metadata-Version: 2.4
Name: Final2x_core
Version: 4.0.0
Summary: core library for Final2x
Project-URL: Homepage, https://github.com/EutropicAI/Final2x-core
Project-URL: Repository, https://github.com/EutropicAI/Final2x-core
Author: Tohrusky
License-Expression: BSD-3-Clause
License-File: LICENSE
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: <4,>=3.9
Requires-Dist: cccv==0.0.4
Requires-Dist: loguru
Requires-Dist: pydantic
Requires-Dist: pyyaml
Description-Content-Type: text/markdown

# Final2x-core

![MacOS](https://img.shields.io/badge/Support-MacOS-blue?logo=Apple&style=flat-square)
![Windows](https://img.shields.io/badge/Support-Windows-blue?logo=Windows&style=flat-square)
![Linux](https://img.shields.io/badge/Support-Linux-blue?logo=Linux&style=flat-square)
[![codecov](https://codecov.io/gh/EutropicAI/Final2x-core/branch/main/graph/badge.svg?token=B2TNKYN4O4)](https://codecov.io/gh/EutropicAI/Final2x-core)
[![CI-test](https://github.com/EutropicAI/Final2x-core/actions/workflows/CI-test.yml/badge.svg)](https://github.com/EutropicAI/Final2x-core/actions/workflows/CI-test.yml)
[![Release](https://github.com/EutropicAI/Final2x-core/actions/workflows/Release.yml/badge.svg)](https://github.com/EutropicAI/Final2x-core/actions/workflows/Release.yml)
[![PyPI version](https://badge.fury.io/py/Final2x-core.svg)](https://badge.fury.io/py/Final2x-core)
![GitHub](https://img.shields.io/github/license/EutropicAI/Final2x-core)

Final2x-core is a cross-platform image super-resolution CLI tool for [Final2x](https://github.com/EutropicAI/Final2x). If you have any questions, please raise an issue [in this repository](https://github.com/EutropicAI/Final2x).

### Install

Download in [Release](https://github.com/EutropicAI/Final2x-core/releases) or use pip to install (Linux User).

Make sure you have Python >= 3.9 and PyTorch >= 2.0 installed

```shell
pip install Final2x-core
```

### cli

```shell
usage: Final2x-core [-h] [-b BASE64] [-j JSON] [-y YAML] [-l] [-n]

when para is not specified, the config.yaml file in the directory will be read automatically

options:
  -h, --help            show this help message and exit
  -b BASE64, --BASE64 BASE64
                        base64 string for config json
  -j JSON, --JSON JSON  JSON string for config
  -y YAML, --YAML YAML  yaml config file path
  -l, --LOG             save log
  -n, --NOTOPENFOLDER   don't open output folder
```

### Config

Refer to config.yaml which generated by the following command:

```shell
make gen
```

### Reference

The following references were used in the development of this project:

After v4.0.0, we use cccv as the algorithm implementation, which implemented most of the features from ccrestoration

- [cccv](https://github.com/EutropicAI/cccv)

---

After v3.0.0, ncnn will be deprecated, and the project will use ccrestoration(PyTorch) as the algorithm implementation.

- [ccrestoration](https://github.com/EutropicAI/ccrestoration)
- [PyTorch](https://github.com/pytorch/pytorch)

---

- [ncnn](https://github.com/Tencent/ncnn)

### License

This project is licensed under the BSD 3-Clause - see
the [LICENSE file](./LICENSE) for details.
