Upload folder using huggingface_hub

.gitattributes

@@ -33,3 +33,14 @@ saved_model/**/* 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
+examples/armored_car_input.png filter=lfs diff=lfs merge=lfs -text
+examples/armored_car_output.png filter=lfs diff=lfs merge=lfs -text
+examples/biplane_input.png filter=lfs diff=lfs merge=lfs -text
+examples/biplane_output.png filter=lfs diff=lfs merge=lfs -text
+examples/jet_fighter_input.png filter=lfs diff=lfs merge=lfs -text
+examples/jet_fighter_output.png filter=lfs diff=lfs merge=lfs -text
+examples/sports_car_input.png filter=lfs diff=lfs merge=lfs -text
+examples/sports_car_output.png filter=lfs diff=lfs merge=lfs -text
+images/banner.png filter=lfs diff=lfs merge=lfs -text
+images/example_input.png filter=lfs diff=lfs merge=lfs -text
+images/example_output.png filter=lfs diff=lfs merge=lfs -text

README.md

@@ -1,3 +1,219 @@
----
-license: apache-2.0
----
+---
+license: apache-2.0
+language:
+- en
+tags:
+- flux
+- flux-2-klein
+- flux-lora
+- lora
+- sprite-sheet
+- game-asset
+- 2x2-grid
+- multi-view
+- isometric
+- top-down
+- side-view
+- image-to-image
+- fal-ai
+pipeline_tag: image-to-image
+widget:
+- src: images/example_input.png
+  output:
+    url: images/example_output.png
+  parameters:
+    lora_scale: 1.1
+---
+
+<div align="center">
+
+# 🎮 Flux 2×2 Sprite Sheet LoRA
+
+### Transform any object into a **2×2 multi-view sprite sheet** with consistent style
+
+[![Try on fal.ai](https://img.shields.io/badge/🚀_Try_it_Live-fal.ai-FF6B35?style=for-the-badge)](https://fal.ai/models/fal-ai/flux-2-klein/4b/base/edit/lora?share=528658ce-ed9c-46be-8e2b-815fbc4d14a6)
+[![License](https://img.shields.io/badge/License-Apache_2.0-green?style=for-the-badge)](https://opensource.org/licenses/Apache-2.0)
+
+<img src="images/banner.png" alt="Sprite Sheet LoRA Banner" width="100%">
+
+</div>
+
+---
+
+## 🎯 What does this model do?
+
+This LoRA transforms **any single object image** into a professional **2×2 sprite sheet** with 4 different camera angles:
+
+```
+┌────────────────────┬────────────────────┐
+│    ISOMETRIC ↘     │    ISOMETRIC ↙     │
+│  Front-right view  │  Front-left view   │
+├────────────────────┼────────────────────┤
+│    SIDE VIEW ←     │    TOP-DOWN ↑      │
+│  Profile from left │  Bird's eye view   │
+└────────────────────┴────────────────────┘
+```
+
+Perfect for **game developers**, **asset creators**, and **3D artists** who need consistent multi-view references.
+
+---
+
+## 🖼️ Examples
+
+<table>
+<tr>
+<th>Input</th>
+<th>Output (2×2 Sprite Sheet)</th>
+</tr>
+<tr>
+<td><img src="examples/jet_fighter_input.png" width="300"></td>
+<td><img src="examples/jet_fighter_output.png" width="300"></td>
+</tr>
+<tr>
+<td><img src="examples/biplane_input.png" width="300"></td>
+<td><img src="examples/biplane_output.png" width="300"></td>
+</tr>
+<tr>
+<td><img src="examples/sports_car_input.png" width="300"></td>
+<td><img src="examples/sports_car_output.png" width="300"></td>
+</tr>
+<tr>
+<td><img src="examples/armored_car_input.png" width="300"></td>
+<td><img src="examples/armored_car_output.png" width="300"></td>
+</tr>
+</table>
+
+---
+
+## 🚀 Quick Start
+
+### Prompt
+
+```
+2x2 sprite sheet
+```
+
+---
+
+## 💻 Usage
+
+### Try it Live on fal.ai
+
+▶️ **[Open Playground](https://fal.ai/models/fal-ai/flux-2-klein/4b/base/edit/lora?share=528658ce-ed9c-46be-8e2b-815fbc4d14a6)**
+
+### With fal.ai SDK
+
+```python
+import fal_client
+
+def on_queue_update(update):
+    if isinstance(update, fal_client.InProgress):
+        for log in update.logs:
+           print(log["message"])
+
+result = fal_client.subscribe(
+    "fal-ai/flux-2-klein/4b/base/edit/lora",
+    arguments={
+        "prompt": "Fill the green spaces according to the image",
+        "model_name": None,
+        "loras": [{
+            "path": "https://huggingface.co/ilkerzgi/flux-spritesheet-lora/resolve/main/flux-spritesheet-lora.safetensors",
+            "scale": 1.1
+        }],
+        "embeddings": [],
+        "image_urls": ["https://your-image-url.png"]
+    },
+    with_logs=True,
+    on_queue_update=on_queue_update,
+)
+print(result)
+```
+
+---
+
+## 📐 Output Layout
+
+The model produces a **2×2 grid** with these specific views:
+
+| Position | View Type | Direction |
+|----------|-----------|-----------|
+| **Top-Left** | Isometric 3/4 | Object faces bottom-right ↘ |
+| **Top-Right** | Isometric 3/4 | Object faces bottom-left ↙ |
+| **Bottom-Left** | Side Profile | Object faces left ← |
+| **Bottom-Right** | Top-Down | Object faces up ↑ |
+
+> All 4 views maintain the same art style, colors, and proportions.
+
+---
+
+## 🎨 About the Red Background
+
+The output uses a **consistent red background** by design. This solid color background:
+- Improves style consistency across all 4 views
+- Makes it easy to remove the background for game integration
+- Ensures clean edges for sprite extraction
+
+---
+
+## 📦 Model Files
+
+| File | Use Case |
+|------|----------|
+| `flux-spritesheet-lora.safetensors` | fal.ai / Diffusers |
+
+---
+
+## 🎓 Training Details
+
+<details>
+<summary>Click to expand</summary>
+
+### Dataset
+- **Size**: 48 curated sprite sheet pairs (from 120 generated, manually validated)
+- **Content**: Diverse vehicle and object categories including:
+  - **Aircraft**: jet fighters, helicopters, biplanes, cargo planes, drones, zeppelins
+  - **Military Vehicles**: tanks, APCs, artillery, humvees, missile launchers
+  - **Civilian Vehicles**: sports cars, motorcycles, trucks, buses, bicycles
+  - **Construction Equipment**: excavators, bulldozers, cranes, forklifts
+  - **Trains**: locomotives, bullet trains, freight trains, trams
+  - **Ships & Boats**: battleships, submarines, yachts, speedboats, kayaks
+  - **Space & Sci-Fi**: rockets, space shuttles, mechs, hover vehicles, UFOs
+- **Style**: Game-ready 2D assets with red background for consistency
+- **Validation**: AI-validated for correct view orientations, then manually curated
+
+### Training
+- **Base Model**: FLUX.2-Klein 4B
+- **Platform**: [fal.ai](https://fal.ai)
+- **Method**: LoRA training
+
+</details>
+
+---
+
+## 🎮 Use Cases
+
+- **Game Development**: Generate sprite sheets for 2D/isometric games
+- **Asset Creation**: Quick multi-view references for 3D modeling
+
+---
+
+## ⚠️ Limitations
+
+- Output background is solid red (by design, for consistency)
+
+---
+
+## 📄 License
+
+[Apache 2.0](https://opensource.org/licenses/Apache-2.0)
+
+---
+
+<div align="center">
+
+### Created by [@ilkerzgi](https://huggingface.co/ilkerzgi) • Trained with [fal.ai](https://fal.ai)
+
+
+[![Try on fal.ai](https://img.shields.io/badge/🚀_Try_it_Live-fal.ai-FF6B35?style=for-the-badge)](https://fal.ai/models/fal-ai/flux-2-klein/4b/base/edit/lora?share=528658ce-ed9c-46be-8e2b-815fbc4d14a6)
+
+</div>

flux-spritesheet-lora.safetensors

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:8aff1fc288755bfc99d91c9d31313062a0d5a0e2935afc3b87edcc431a45da5a
+size 76039072