README.md

# Sking: Image To Minecraft Skin Generator

**Sking** is an image-to-Minecraft-skin generation model designed to transform character images, portraits, avatars, or concept art into Minecraft-style skin textures. Given a reference image, the model learns to preserve key visual features such as clothing, colors, hairstyle, and character identity while adapting them into the compact pixel-art structure used by Minecraft skins.

## 🔗 Resources

* **🌐 Online Demo**: [EntropyDrop Web Portal](https://entropydrop.com)
* **🗂️ Dataset**: [Hugging Face Sking Dataset](https://huggingface.co/datasets/EntropyDrop/Sking)
* **🧠 Trained Model**: [Hugging Face Sking Model](https://huggingface.co/EntropyDrop/Sking)
* **📝 Technical Report**: [Technical Architecture](https://entropydrop.com/skin/public/article/skingen)
* **YouTube**: [YouTube](https://youtu.be/n5t48aNm9Ew)

## Examples

![girl3|240](examples/girl3_original.jpg)
![girl3|240](examples/girl3_gen.jpg)
![cat2|240](examples/cat2_original.jpg)
![cat2|240](examples/cat2_gen.jpg)

![boy|240](examples/boy_original.jpg)
![boy|240](examples/boy_gen.jpg)
![girl|240](examples/girl_original.jpg)
![girl|240](examples/girl_gen.jpg)

![boy2|240](examples/boy2_original.jpg)
![boy2|240](examples/boy2_gen.jpg)
![girl|240](examples/girl2_original.jpg)
![girl|240](examples/girl2_gen.jpg)

![linux|240](examples/linux_original.jpg)
![linux|240](examples/linux_gen.jpg)
![golang|240](examples/golang_original.jpg)
![golang|240](examples/golang_gen.jpg)
![pink|240](examples/pink_original.jpg)
![pink|240](examples/pink_gen.jpg)

![beethoven|240](examples/beethoven_original.jpg)
![beethoven|240](examples/beethoven_gen.jpg)
![boy3|240](examples/boy3_original.jpg)
![boy3|240](examples/boy3_gen.jpg)

![puppy|240](examples/dog_original.jpg)
![puppy|240](examples/dog_gen.jpg)
![cat|240](examples/cat_original.jpg)
![cat|240](examples/cat_gen.jpg)

## Delopy locally

```
python ./infer.py
```

## License

This project is licensed under the GNU Affero General Public License v3.0 - see the [LICENSE](LICENSE) file for details.