Sking / README.md
ramuuuo's picture EntropyDrop's picture
Duplicate from EntropyDrop/Sking
cbe1737
|
Raw History Blame Contribute Delete
3.47 kB
---
license: agpl-3.0
tags:
- minecraft
- image-to-skin
- dense-uv
---
# 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.
## SKING_DDJ_v101c — recommended production UV release (2026-09-16)
The portable v101c render-to-UV bundle is available in [`SKING_DDJ_v101c/`](SKING_DDJ_v101c). It contains privacy-sanitized inference checkpoints with tensor weights identical to the deployed v101 crown-geometry release, the trained foreground model, pinned offline dependencies, UV mappings, source code, checksums, and a portable launcher.
See the [v101c download and inference instructions](SKING_DDJ_v101c/README.md). Download the complete directory rather than only `parser.pt`. The older v104 release remains available below for reproducibility.
## SKING_DDJ_v104 — production UV release (2026-09-08)
The full v104 render-to-UV bundle is available in [`SKING_DDJ_v104/`](SKING_DDJ_v104). It includes the dense UV parser, trained foreground model, BiRefNet and SigLIP2 dependencies, pinned runtime, UV mappings, and a portable inference launcher. It produces a 64×64 RGBA Minecraft skin from the combined front/back edited render.
See the [v104 download and inference instructions](SKING_DDJ_v104/README.md). Download the complete directory rather than only `parser.pt`. Earlier model versions remain available below. The root `infer.py` is the earlier image-generation entry point; use `SKING_DDJ_v104/infer.py` for this release.
## 🔗 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/public/blog/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.