Deepmindbreak THIS PROJECT IS STILL in DEVELOPMENT. DO NOT

deeppomf / DeepMindBreak

Dismiss Join GitHub today GitHub is home to over 20 million developers working together to host and review code, manage projects, and build software together.

Decensoring Hentai with Deep Neural Networks

# hentai # deep-learning # anime # neural-network # gan # tensorflow

92 commits 1 branch 0 releases 2 contributors

master New pull request Find file Clone or download

Latest commit 1f4f847 Mar 8, 2018 deeppomf decensor color added to config

models update Feb 11, 2018

readme_images guide update Feb 11, 2018

training_data remove print statemetns Feb 27, 2018

LICENSE decensor color added to config Mar 8, 2018

README.md decensor color added to config Mar 8, 2018

config.py decensor color added to config Mar 8, 2018

decensor.py decensor color added to config Mar 8, 2018

layer.py update Feb 11, 2018

load.py update Feb 11, 2018

model.py update Feb 11, 2018

model_mosaic.py Add files via upload Feb 19, 2018

poisson_blend.py readme, decensor Feb 11, 2018

test.py added testing output path to args Feb 27, 2018

train.py stop samples from being generated with small datasets Mar 1, 2018

train_mosaic.py Add files via upload Feb 19, 2018

README.md

DeepMindBreak

Decensoring Hentai with Deep Neural Networks

This project applies an implementation of Globally and Locally Consistent Image Completion to the problem of hentai decensorship. Using a deep fully convolutional neural network, DeepMindBreak can replace censored artwork in hentai with plausible reconstructions. The user needs to only specify the censored regions.

THIS PROJECT IS STILL IN DEVELOPMENT. DO NOT BE DISAPPOINTED IF THE RESULTS AREN'T AS GOOD AS YOU EXPECT.

Limitations

This project is LIMITED in capability. It is a proof of concept of ongoing research.

The decensorship is intended to ONLY work on color hentai images that have minor bar censorship of the penis or vagina.

It does NOT work with:

Black and white images Monochrome images Hentai containing screentones (e.g. printed hentai) Real life porn Mosaic censorship Censorship of nipples Censorship of anus Animated gifs/videos

In particular, if a vagina or penis is completely censored out, inpainting will be ineffective.

Embarrassingly, because the neural network was trained to decensor horizontally and vertically oriented rectangles, it has trouble with angled rectangles. This will be fixed soon.

Dependencies

Python 2/3 TensorFlow 1.5 Pillow tqdm scipy pyamg (only needed if poisson blending is enabled in decensor.py) matplotlib (only for running test.py)

No GPU required! Tested on Ubuntu 16.04 and Windows.

Poisson blending is disabled by default since it has little effect on output quality.

Pillow, tqdm, scipy, pyamg, and matplotlib can all be installed using pip.

Model

The pretrained model can be downloaded from https://drive.google.com/open? id=1mWHYSj0LDSbJQQxjR4hUMykQkVve2U3Q.

Unzip the contents into the /models/ folder.

Usage

I. Decensoring hentai

The decensorship process is fairly involved. A user interface will eventually be released to streamline the process.

Using image editing software like Photoshop or GIMP, paint the areas you want to decensor the color with RGB values of (0,255,0). You can change the mask color in config. For each censored region, crop 128 x 128 size images containing the censored regions from your images and save them as new ".png" images.

Move the cropped images to the "decensor_input_images" directory. Decensor the images by running

$ python decensor.py

Decensored images will be saved to the "decensor_output_images" directory. Paste the decensored images back into the original image.

II. Train the pretrained model on custom dataset

You must have a GPU for training since training on a CPU will take weeks.

Your custom dataset should be 128 x 128 images of uncensored vaginas and penises cropped from hentai. The more images, the better: I used 70,000 images for training. Censoring these images yourself is unnecessary.

Put your custom dataset for training in the "training_data/images" directory and convert images to npy format.

$ cd training_data $ python to_npy.py

To train, run

$ python train.py

If desired, you can train the pretrained model on your custom dataset by running

$ python train.py --continue_training=True

Training can be done separately for mosaics with train_mosaic.py, but decensor.py is not yet compatible with mosaic decensorship models.

To do

Add Python 3 compatibility Add random rotations in cropping rectangles Retrain for arbitrary shape censors Add a user interface Incorporate GAN loss into training Update the model to the new version

Contributions are welcome! Special thanks to StartleStars for contributing code for mosaic decensorship.

License

Example image by dannychoo under CC BY-NC-SA 2.0 License. The example image is modified from the original, which can be found here.

Model is licensed under CC BY-NC-SA 4.0 License.

Code is licensed under CC BY-NC-SA 4.0 License and is modified from tadax's project Globally and Locally Consistent Image Completion with TensorFlow and shinseung428's project [https://github.com/shinseung428/GlobalLocalImageCompletion_TF], which are implementations of the paper Globally and Locally Consistent Image Completion. It also has a modified version of parosky's project poissonblending.

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.