<p>A pixel art spritesheet LoRA for small 32x32 characters, with animation frames for walking up/down/left/right, standing with both arms raised, jumping left/right, and lying on the floor.</p><p></p><h3 id="how-to-use">How to use</h3><p>You can use the default FLUX.2 Klein base 4B workflows from ComfyUI. Both the text-to-image workflow and the edit base workflow work.</p><p>Images should be 512x512 because that's the size of the spritesheets used in training.</p><p></p><h3 id="does-this-lora-work-with-flux.2-klein-4b-distilled">Does this LoRA work with FLUX.2 Klein 4B distilled?</h3><p>No. It's technically compatible, but the distilled model ruins the quality of the pixels and the consistency. Use the base model.</p><p></p><h3 id="how-to-get-pixel-perfect-images">How to get pixel-perfect images</h3><p>To get pixel-perfect images, downscale by a factor of 4. So 512x512 images should downscale to 128x128. Using k-centroid scaling works well.</p><p></p><h3 id="testing-the-spritesheets-in-a-game">Testing the spritesheets in a game</h3><p>If you want to quickly test your spritesheets in a 2D game, here's a simple "sandbox" game/tool where you can upload the raw spritesheet outputs and spawn in your characters to move around:</p><p>Link to tool <a target="_blank" rel="ugc" href="https://svntax.github.io/pixel-art-spritesheet-sandbox/">here</a></p><p>Source code <a target="_blank" rel="ugc" href="https://github.com/svntax/pixel-art-spritesheet-sandbox">here</a></p><p></p><h3 id="credits">Credits</h3><ul><li><p>The dataset used to train this LoRA consists of spritesheets edited and based on a template spritesheet by <a target="_blank" rel="ugc" href="https://opengameart.org/content/16x16-game-assets">George Bailey</a>, licensed under <a target="_blank" rel="ugc" href="https://creativecommons.org/licenses/by/4.0/">CC BY 4.0</a></p></li></ul><p></p>

Pixel Art Spritesheet - 4-Walk Small

<p><strong>Version 1.0 Notes</strong></p><p>This is a first attempt at making a pixel art spritesheet LoRA using small sprites. There are sometimes bad images generated with issues like hair or headwear being cut off, and non-human characters with bad anatomy. The bottom row of sprites with the back view also has problems with consistency sometimes (for example, the werewolf sample is missing the red scarf).</p><p>You can also find two files for version 1 of this LoRA on <a target="_blank" rel="ugc" href="https://huggingface.co/svntax-dev/pixel_spritesheet_4walk_small_lora_v1">HuggingFace</a></p><p>The 2750-steps LoRA and the 3000-steps LoRA are available there. The 3000-steps version seems to be more consistent in making humanoid characters, but the 2750-steps version seems a bit more creative in non-humanoid characters if using edit + an image reference.</p>

pixel_4walk_small_flux2_klein_base_4b_v1.safetensors

v1.0

### You can access the model files in the "Files and versions" tab.
#### Model files may be downloaded with ModelScope SDK or through git clone directly.

### LoRA Description

A pixel art spritesheet LoRA for small 32x32 characters, with animation frames for walking up/down/left/right, standing with both arms raised, jumping left/right, and lying on the floor.

Download with ModelScope’s Python SDK
```bash
#Install ModelScope
pip install modelscope
```
```python
#Download with ModelScope’s Python SDK
from modelscope import snapshot_download
model_dir = snapshot_download('svntax/pixel_spritesheet_4walk_small_lora_v1')
```
Download with Git clone
```
git clone https://www.modelscope.ai/svntax/pixel_spritesheet_4walk_small_lora_v1.git
```

### How to use

You can generate spritesheets with text only, or you can use a reference image of a character. Image outputs must be 512x512 because that's the size of the spritesheets used in training.

### How to get pixel-perfect images

Downscale by a factor of 4. So 512x512 output images should downscale to 128x128. Using k-centroid scaling, for example, works well.


svntax/pixel_spritesheet_4walk_small_lora_v1

For image reference, use this prompt:Create a pixel art spritesheet of the character in the image. The spritesheet is a 4 by 4 grid of four rows of frames - first row is 3 walking frames facing down and 1 frame both arms raised, second row is 3 walking frames facing left and 1 frame jumping left, third row is 3 walking frames facing right and 1 frame jumping right, fourth row is 3 walking frames back view facing up and 1 frame lying on floor.For text-to-image, use this prompt:A pixel art spritesheet of <character description>. The spritesheet is a 4 by 4 grid of four rows of frames - first row is 3 walking frames facing down and 1 frame both arms raised, second row is 3 walking frames facing left and 1 frame jumping left, third row is 3 walking frames facing right and 1 frame jumping right, fourth row is 3 walking frames back view facing up and 1 frame lying on floor.

Files with SHA256: a968c042c2443bf6bfed41ce833a0e06bf5bbb7961ac40b88fb7257a940ae54e