DeepCreamPy/README.md

74 lines
4.2 KiB
Markdown
Raw Normal View History

2018-10-20 04:30:35 +00:00
# DeepCreamPy
2018-11-11 01:53:48 +00:00
*Decensoring Hentai with Deep Neural Networks.*
2019-03-01 09:00:48 +00:00
2021-04-27 17:49:31 +00:00
[![GitHub release](https://img.shields.io/github/release/gguilt/DeepCreamPy.svg)](https://github.com/gguilt/DeepCreamPy/releases/latest)
[![GitHub downloads](https://img.shields.io/github/downloads/gguilt/DeepCreamPy/latest/total.svg)](https://github.com/gguilt/DeepCreamPy/releases/latest)
[![GitHub downloads](https://img.shields.io/github/downloads/gguilt/DeepCreamPy/total.svg)](https://github.com/gguilt/DeepCreamPy/releases)
[![GitHub issues](https://img.shields.io/github/issues/gguilt/DeepCreamPy.svg)](https://github.com/gguilt/DeepCreamPy/issues)
2018-10-20 04:00:04 +00:00
2018-10-30 11:39:08 +00:00
A deep learning-based tool to automatically replace censored artwork in hentai with plausible reconstructions.
2018-10-30 08:30:27 +00:00
2021-04-27 17:49:31 +00:00
Before DeepCreamPy can be used, the user must color censored regions in their hentai green with an image editing program (e.g. GIMP, Photoshop). DeepCreamPy takes the green colored images as input, and a neural network automatically fills in the censored regions.
2018-10-30 08:30:27 +00:00
2021-04-27 17:49:31 +00:00
You can download the latest release for Windows 64-bit [here](https://github.com/gguilt/DeepCreamPy/releases/latest).
2019-08-12 03:08:07 +00:00
For users interested in compiling DeepCreamPy themselves, DeepCreamPy can run on Windows, Mac, and Linux.
2018-10-20 04:00:04 +00:00
2021-04-27 17:49:31 +00:00
Please before you open a new issue check [closed issues](https://github.com/gguilt/DeepCreamPy/issues?q=is%3Aissue+is%3Aclosed) and check the [table of contents](https://github.com/gguilt/DeepCreamPy#table-of-contents).
2018-12-21 20:22:45 +00:00
2018-11-11 02:40:46 +00:00
<p align="center">
2021-04-27 17:49:31 +00:00
<img src="https://github.com/gguilt/DeepCreamPy/blob/master/readme_images/mermaid_collage.png" width="800">
2018-11-11 02:40:46 +00:00
</p>
2018-10-20 04:00:04 +00:00
2018-11-02 09:53:12 +00:00
## Features
2019-11-02 03:43:02 +00:00
- Decensoring images of any size
2018-11-05 05:20:52 +00:00
- Decensoring of ANY shaped censor (e.g. black lines, pink hearts, etc.)
2019-08-07 08:32:49 +00:00
- Decensoring of mosaic decensors
2019-08-07 22:00:25 +00:00
- Limited support for decensoring black and white/monochrome images
2019-11-02 03:43:02 +00:00
- Generate multiple variations of decensors from the same image
2018-10-20 04:00:04 +00:00
2018-10-25 22:35:49 +00:00
## Limitations
2021-04-27 17:49:31 +00:00
The decensorship is for color hentai images that have minor to moderate censorship of the human reproductive organs. If an organ is completely censored out, decensoring will be ineffective.
2018-10-20 22:12:38 +00:00
2018-10-20 04:00:04 +00:00
It does NOT work with:
2018-11-05 05:20:52 +00:00
- Hentai with screentones (e.g. printed hentai)
2021-04-27 17:49:31 +00:00
- Real life pornographic material
2018-10-20 04:00:04 +00:00
- Censorship of nipples
2021-04-27 17:49:31 +00:00
- Censorship of lower orifice of the alimentary canal
2018-10-20 04:00:04 +00:00
- Animated gifs/videos
2018-11-02 09:22:11 +00:00
## Table of Contents
Setup:
2019-08-26 22:21:43 +00:00
* [Running latest Window 64-bit release](docs/INSTALLATION_BINARY.md)
2018-11-13 07:21:09 +00:00
* [Running code yourself](docs/INSTALLATION.md)
2018-10-20 04:42:48 +00:00
2018-11-02 09:22:11 +00:00
Usage:
2018-11-13 07:21:09 +00:00
* [Decensoring tutorial](docs/USAGE.md)
* [Troubleshooting for installing](docs/TROUBLESHOOTING.md)
* [Troubleshooting for poor quality decensors](docs/TROUBLESHOOTING_DECENSORS.md)
2018-10-20 07:17:33 +00:00
2018-11-02 09:22:11 +00:00
Miscellaneous:
2018-11-13 07:21:09 +00:00
* [FAQ](docs/FAQ.md)
2018-10-25 22:34:02 +00:00
2018-10-25 22:35:49 +00:00
## To do
2019-03-01 09:00:17 +00:00
- Resolve all Tensorflow compatibility problems
- Finish the user interface
2018-10-30 08:30:27 +00:00
- Add error log
2018-10-20 04:00:04 +00:00
2019-08-07 08:26:10 +00:00
## Contributions
2019-10-30 23:30:55 +00:00
If you want to make a pull request to DeepCreamPy, you must first sign our [Contributor License Agreement](https://github.com/deeppomf/contributing/blob/master/sign-cla.md#sign-the-cla) (the "CLA"). Then I can accept your pull requests.
2019-08-07 08:26:10 +00:00
2019-11-17 02:51:57 +00:00
Special thanks to ccppoo, IAmTheRedSpy, 0xb8, deniszh, Smethan, harjitmoe, itsVale, StartleStars, and SoftArmpit for their contributions!
2018-10-20 04:00:04 +00:00
2018-10-25 22:35:49 +00:00
## License
2020-04-22 02:11:02 +00:00
Source code and official releases/binaries are distributed under the [GNU Affero General Public License v3.0](LICENSE.md).
2018-10-22 22:25:59 +00:00
2018-10-25 22:35:49 +00:00
## Acknowledgements
2018-10-22 02:30:04 +00:00
Example mermaid image by Shurajo & AVALANCHE Game Studio under [CC BY 3.0 License](https://creativecommons.org/licenses/by/3.0/). The example image is modified from the original, which can be found [here](https://opengameart.org/content/mermaid).
2018-10-20 04:43:56 +00:00
2019-08-06 21:39:40 +00:00
Neural network code is modified from Forty-lock's project [PEPSI](https://github.com/Forty-lock/PEPSI), which is the official implementation of the paper [PEPSI : Fast Image Inpainting With Parallel Decoding Network](http://openaccess.thecvf.com/content_CVPR_2019/html/Sagong_PEPSI__Fast_Image_Inpainting_With_Parallel_Decoding_Network_CVPR_2019_paper.html). [PEPSI](https://github.com/Forty-lock/PEPSI) is licensed under the MIT license.
2018-10-20 04:00:04 +00:00
2019-08-06 21:39:40 +00:00
Training data is modified from gwern's project [Danbooru2017: A Large-Scale Crowdsourced and Tagged Anime Illustration Dataset](https://www.gwern.net/Danbooru2017) and other sources.
2018-10-30 01:04:07 +00:00
2018-11-13 07:21:09 +00:00
See [ACKNOWLEDGEMENTS.md](docs/ACKNOWLEDGEMENTS.md) for full license text of these projects.