DeepCreamPy/README.md

81 lines
4.6 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
2018-11-11 01:53:48 +00:00
[![GitHub release](https://img.shields.io/github/release/deeppomf/DeepCreamPy.svg)](https://github.com/deeppomf/DeepCreamPy/releases/latest)
2018-11-11 01:54:50 +00:00
[![GitHub downloads](https://img.shields.io/github/downloads/deeppomf/DeepCreamPy/latest/total.svg)](https://github.com/deeppomf/DeepCreamPy/releases/latest)
[![GitHub downloads](https://img.shields.io/github/downloads/deeppomf/DeepCreamPy/total.svg)](https://github.com/deeppomf/DeepCreamPy/releases)
2018-11-11 01:59:41 +00:00
[![GitHub issues](https://img.shields.io/github/issues/deeppomf/DeepCreamPy.svg)](https://github.com/deeppomf/DeepCreamPy/issues)
[![Donate with PayPal](https://img.shields.io/badge/paypal-donate-green.svg)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=SAM6C6DQRDBAE)
2018-11-11 03:29:06 +00:00
[![Twitter Follow](https://img.shields.io/twitter/follow/deeppomf.svg?label=Follow&style=social)](https://twitter.com/deeppomf/)
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
2019-08-11 20:27:10 +00:00
Before DeepCreamPy can be used, the user must color censored regions in their hentai green with an image editing program like GIMP or 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
2019-08-12 03:08:07 +00:00
You can download the latest release for Windows 64-bit [here](https://github.com/deeppomf/DeepCreamPy/releases/latest).
For users interested in compiling DeepCreamPy themselves, DeepCreamPy can run on Windows, Mac, and Linux.
2018-10-20 04:00:04 +00:00
2019-03-01 09:00:17 +00:00
Please before you open a new issue check [closed issues](https://github.com/deeppomf/DeepCreamPy/issues?q=is%3Aissue+is%3Aclosed) and check the [table of contents](https://github.com/deeppomf/DeepCreamPy#table-of-contents).
2018-12-21 20:22:45 +00:00
2018-11-11 02:40:46 +00:00
<p align="center">
<img src="https://github.com/deeppomf/DeepCreamPy/blob/master/readme_images/mermaid_collage.png" width="800">
</p>
2018-10-20 04:00:04 +00:00
2018-11-02 09:53:12 +00:00
## Features
2018-10-20 04:00:04 +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-10-18 00:22:43 +00:00
- Generate multiple variations of decensors from the same image (**Available in the v2.2.0 alpha release**)
2018-10-20 04:00:04 +00:00
2018-10-25 22:35:49 +00:00
## Limitations
2018-11-05 05:20:52 +00:00
The decensorship is for color hentai images that have minor to moderate censorship of the penis or vagina. If a vagina or penis 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)
2018-10-20 04:00:04 +00:00
- Real life porn
- Censorship of nipples
- Censorship of anus
- 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-05-10 15:05:59 +00:00
Follow me on Twitter [@deeppomf](https://twitter.com/deeppomf) (NSFW Tweets) for project updates.
2018-11-05 13:32:34 +00:00
2019-08-07 08:26:10 +00:00
## Contributions
Contributions are closed for the near future.
Special thanks to ccppoo, IAmTheRedSpy, 0xb8, deniszh, Smethan, mrmajik45, 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
2019-08-08 02:37:25 +00:00
Source code and official releases/binaries are distributed under the [EULA](EULA.txt).
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.
2018-10-28 07:10:58 +00:00
## Donations
2019-08-06 21:55:19 +00:00
If you like the work I do, you can donate to me via Paypal. The funds will go towards keeping me alive. [![Donate](https://img.shields.io/badge/Donate-PayPal-green.svg)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=SAM6C6DQRDBAE)