initial commit

.gitattributes

@@ -0,0 +1,55 @@
+*.7z filter=lfs diff=lfs merge=lfs -text
+*.arrow filter=lfs diff=lfs merge=lfs -text
+*.bin filter=lfs diff=lfs merge=lfs -text
+*.bz2 filter=lfs diff=lfs merge=lfs -text
+*.ckpt filter=lfs diff=lfs merge=lfs -text
+*.ftz filter=lfs diff=lfs merge=lfs -text
+*.gz filter=lfs diff=lfs merge=lfs -text
+*.h5 filter=lfs diff=lfs merge=lfs -text
+*.joblib filter=lfs diff=lfs merge=lfs -text
+*.lfs.* filter=lfs diff=lfs merge=lfs -text
+*.lz4 filter=lfs diff=lfs merge=lfs -text
+*.mlmodel filter=lfs diff=lfs merge=lfs -text
+*.model filter=lfs diff=lfs merge=lfs -text
+*.msgpack filter=lfs diff=lfs merge=lfs -text
+*.npy filter=lfs diff=lfs merge=lfs -text
+*.npz filter=lfs diff=lfs merge=lfs -text
+*.onnx filter=lfs diff=lfs merge=lfs -text
+*.ot filter=lfs diff=lfs merge=lfs -text
+*.parquet filter=lfs diff=lfs merge=lfs -text
+*.pb filter=lfs diff=lfs merge=lfs -text
+*.pickle filter=lfs diff=lfs merge=lfs -text
+*.pkl filter=lfs diff=lfs merge=lfs -text
+*.pt filter=lfs diff=lfs merge=lfs -text
+*.pth filter=lfs diff=lfs merge=lfs -text
+*.rar filter=lfs diff=lfs merge=lfs -text
+*.safetensors filter=lfs diff=lfs merge=lfs -text
+saved_model/**/* filter=lfs diff=lfs merge=lfs -text
+*.tar.* filter=lfs diff=lfs merge=lfs -text
+*.tar filter=lfs diff=lfs merge=lfs -text
+*.tflite filter=lfs diff=lfs merge=lfs -text
+*.tgz filter=lfs diff=lfs merge=lfs -text
+*.wasm filter=lfs diff=lfs merge=lfs -text
+*.xz filter=lfs diff=lfs merge=lfs -text
+*.zip filter=lfs diff=lfs merge=lfs -text
+*.zst filter=lfs diff=lfs merge=lfs -text
+*tfevents* filter=lfs diff=lfs merge=lfs -text
+# Audio files - uncompressed
+*.pcm filter=lfs diff=lfs merge=lfs -text
+*.sam filter=lfs diff=lfs merge=lfs -text
+*.raw filter=lfs diff=lfs merge=lfs -text
+# Audio files - compressed
+*.aac filter=lfs diff=lfs merge=lfs -text
+*.flac filter=lfs diff=lfs merge=lfs -text
+*.mp3 filter=lfs diff=lfs merge=lfs -text
+*.ogg filter=lfs diff=lfs merge=lfs -text
+*.wav filter=lfs diff=lfs merge=lfs -text
+# Image files - uncompressed
+*.bmp filter=lfs diff=lfs merge=lfs -text
+*.gif filter=lfs diff=lfs merge=lfs -text
+*.png filter=lfs diff=lfs merge=lfs -text
+*.tiff filter=lfs diff=lfs merge=lfs -text
+# Image files - compressed
+*.jpg filter=lfs diff=lfs merge=lfs -text
+*.jpeg filter=lfs diff=lfs merge=lfs -text
+*.webp filter=lfs diff=lfs merge=lfs -text

README.md

@@ -0,0 +1,106 @@
+---
+tags:
+- text-to-image
+- lora
+- diffusers
+- template:diffusion-lora
+widget:
+- output:
+    url: images/Boogu_image_edit_00079_.png
+  text: >-
+    A pixel art spritesheet of a witch with long red hair and blue eyes, wearing
+    a purple hat and robes trimmed with white and light purple colors. The
+    spritesheet is a 6 by 4 grid of four rows and six columns of frames - First
+    row is 3 walking frames facing down, 2 arm swing attack frames facing down,
+    and 1 hurt frame facing down. Second row is 3 walking frames facing left, 2
+    arm swing attack frames facing left, and 1 hurt frame facing left. Third row
+    is 3 walking frames facing right, 2 arm swing attack frames facing right,
+    and 1 hurt frame facing right. Fourth row is 3 walking frames back view
+    facing up, 2 arm swing attack frames back view facing up, and 1 hurt frame
+    back view facing up.
+- output:
+    url: images/Boogu_image_edit_00080_.png
+  text: >-
+    A pixel art spritesheet of a medieval knight wearing metal armor and a
+    helmet with a red plume. The spritesheet is a 6 by 4 grid of four rows and
+    six columns of frames - First row is 3 walking frames facing down, 2 arm
+    swing attack frames facing down, and 1 hurt frame facing down. Second row is
+    3 walking frames facing left, 2 arm swing attack frames facing left, and 1
+    hurt frame facing left. Third row is 3 walking frames facing right, 2 arm
+    swing attack frames facing right, and 1 hurt frame facing right. Fourth row
+    is 3 walking frames back view facing up, 2 arm swing attack frames back view
+    facing up, and 1 hurt frame back view facing up.
+- output:
+    url: images/Boogu_image_edit_00081_.png
+  text: >-
+    A pixel art spritesheet of a werewolf with light gray fur and yellow eyes,
+    wearing a red scarf around his neck, and brown leather pants. The
+    spritesheet is a 6 by 4 grid of four rows and six columns of frames - First
+    row is 3 walking frames facing down, 2 arm swing attack frames facing down,
+    and 1 hurt frame facing down. Second row is 3 walking frames facing left, 2
+    arm swing attack frames facing left, and 1 hurt frame facing left. Third row
+    is 3 walking frames facing right, 2 arm swing attack frames facing right,
+    and 1 hurt frame facing right. Fourth row is 3 walking frames back view
+    facing up, 2 arm swing attack frames back view facing up, and 1 hurt frame
+    back view facing up.
+base_model: Boogu/Boogu-Image-0.1-Edit
+instance_prompt: null
+license: apache-2.0
+---
+# pixel_spritesheet_4walk_combat_32x48_v2
+
+<Gallery />
+
+## Model description 
+
+A pixel art spritesheet LoRA for small 32x48 characters, with animation frames for walking up&#x2F;down&#x2F;left&#x2F;right, 2 attack frames with an arm swing, and 1 hurt frame.
+
+Trained on Boogu Image 0.1 Edit.
+
+## How to use
+
+Use &#x60;boogu_image_edit_turbo_hotfix_1k_20260708_int8_convrot.safetensors&#x60; from Comfy-Org&#39;s Hugging Face repo: https:&#x2F;&#x2F;huggingface.co&#x2F;Comfy-Org&#x2F;Boogu-Image
+
+You&#39;ll also need the custom node &#x60;TextEncodeBooguEditAnyRes&#x60; from here: https:&#x2F;&#x2F;github.com&#x2F;svntax&#x2F;ComfyUI-BooguImageEdit-AnyRes
+
+Drag and drop the sample images into ComfyUI for the workflow, or use the one in the repo.
+
+Image outputs should be 768x768 because that&#39;s the size of the spritesheets used in training. But, you can use the model as a normal edit model or text-to-image too.
+
+### Why a custom node?
+
+ComfyUI&#39;s default &#x60;TextEncodeBooguEdit&#x60; node has issues with some resolutions, where you don&#39;t get an output matching your reference image&#39;s size. The custom node fixes this.
+
+## How to get pixel-perfect images
+
+Downscale by a factor of 4. So 768x768 images should downscale to 192x192. The workflow uses [PixelOE](https:&#x2F;&#x2F;github.com&#x2F;KohakuBlueleaf&#x2F;PixelOE) with k-centroid mode, but other 4x downscale can work too.
+
+# Using an image reference
+
+Prompt: *Create a pixel art spritesheet of the character in the image. Keep the appearance the same. The spritesheet is a 6 by 4 grid of four rows and six columns of frames - First row is 3 walking frames facing down, 2 arm swing attack frames facing down, and 1 hurt frame facing down. Second row is 3 walking frames facing left, 2 arm swing attack frames facing left, and 1 hurt frame facing left. Third row is 3 walking frames facing right, 2 arm swing attack frames facing right, and 1 hurt frame facing right. Fourth row is 3 walking frames back view facing up, 2 arm swing attack frames back view facing up, and 1 hurt frame back view facing up.*
+
+![demon_man_image_ref](https:&#x2F;&#x2F;cdn-uploads.huggingface.co&#x2F;production&#x2F;uploads&#x2F;68dcbc0eb3e9381d15e2cbbc&#x2F;6pSMAQiaINJDUyrLeQrPq.png)
+
+![astronaut_image_ref](https:&#x2F;&#x2F;cdn-uploads.huggingface.co&#x2F;production&#x2F;uploads&#x2F;68dcbc0eb3e9381d15e2cbbc&#x2F;qaJPnBUJyQ-rT-cBjYMdN.png)
+
+![bluejay_image_ref](https:&#x2F;&#x2F;cdn-uploads.huggingface.co&#x2F;production&#x2F;uploads&#x2F;68dcbc0eb3e9381d15e2cbbc&#x2F;jxUg8dJ9rQwgD9bxq_9Qz.png)
+
+
+## Image to pixel art
+
+Surprisingly, you can use this LoRA to change a reference image into pixel art, but it doesn&#39;t work with every type of image, and seems to work best at 768x768 and similar scale.
+
+Example: *Change this image into pixel art*
+
+![img_to_pixel_5](https:&#x2F;&#x2F;cdn-uploads.huggingface.co&#x2F;production&#x2F;uploads&#x2F;68dcbc0eb3e9381d15e2cbbc&#x2F;1N1WrSnjrp9qn3b-BiyZN.png)
+
+
+## Notes &amp; Issues
+- Backgrounds from the reference image carry over to the spritesheet, so if you have a reference image with a background, add something like &quot;White background&quot; to the prompt so the spritesheet doesn&#39;t generate it.
+- Normal edit prompts still have the same weaknesses that the original model has (character identity drift, complex pose changes).
+
+
+## Download model
+
+
+[Download](/svntax-dev/pixel_spritesheet_4walk_combat_32x48_v2/tree/main) them in the Files & versions tab.