Current public release

.env.example

@@ -0,0 +1,2 @@
+COMFY_URL=https://cloud.comfy.org
+COMFY_API_KEY=

.gitattributes

@@ -0,0 +1,37 @@
+*.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
+*.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
+examples/cloud_t03_comfy_converted.png filter=lfs diff=lfs merge=lfs -text
+examples/cloud_t05_comfy_converted.png filter=lfs diff=lfs merge=lfs -text

.gitignore

@@ -0,0 +1,7 @@
+__pycache__/
+.venv/
+outputs/
+.env
+.env.*
+!.env.example
+*.pyc

LICENSE-CODE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Baragi AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

LICENSE.md

@@ -0,0 +1,53 @@
+FLUX Non-Commercial License v2.1
+
+Black Forest Labs Inc. (“we” or “our” or “Company”) is pleased to make the weights, parameters, and inference code for the FLUX Model (as defined below) freely available for your non-commercial and non-production use as set forth in this FLUX Non-Commercial License (“License”).  “FLUX Model” includes, individually and collectively, the models denoted as FLUX.x [dev], where “.x” denotes the FLUX Model version number, and models made available under the License, as indicated by a license notice that is included in or attached to the work, and their elements which includes algorithms, software, checkpoints, parameters, source code (inference code, evaluation code, and if applicable, fine-tuning code) and any other materials associated with the FLUX AI models made available by Company under this License, including if any, the technical documentation, manuals, and instructions for the use and operation thereof. Note that we may also make available certain elements of what is included in the definition of “FLUX Model” under a separate license, such as the inference code, and nothing in this License will be deemed to restrict or limit any other licenses granted by us in such elements.
+
+By downloading, accessing, using, Distributing (as defined below), or creating a Derivative (as defined below) of the FLUX Model, you agree to the terms of this License. If you do not agree to this License, then you do not have any rights to access, use, Distribute or create a Derivative of the FLUX Model and you must immediately cease using the FLUX Model. If you are agreeing to be bound by the terms of this License on behalf of your employer or other entity, you represent and warrant to us that you have full legal authority to bind your employer or such entity to this License. If you do not have the requisite authority, you may not accept the License or access the FLUX Model on behalf of your employer or other entity.
+
+ 1. Definitions.
+ - a. “Derivative”  means any (i) modified version of the FLUX Model (including but not limited to any customized or fine-tuned version thereof), (ii) work based on the FLUX Model, or (iii) any other derivative work thereof. For the avoidance of doubt, Outputs are not considered Derivatives under this License.
+ - b. “Distribution” or “Distribute” or “Distributing” means providing or making available, by any means, a copy of the FLUX Model and/or the Derivatives as the case may be.
+ - c. “Non-Commercial Purpose” means any of the following uses, but only so far as you do not receive any direct or indirect payment arising from the use of the FLUX Model, Derivatives, or Content Filters (as defined below): (i) personal use for research, experimentation, and testing for the benefit of public knowledge, personal study, private entertainment, hobby projects, or otherwise not directly or indirectly connected to any commercial activities, business operations, or employment responsibilities; (ii) use by commercial or for-profit entities for testing, evaluation, or non-commercial research and development in a non-production environment; and (iii) use by any charitable organization for charitable purposes, or for testing or evaluation. For clarity, use (a) for revenue-generating activity, (b) in direct interactions with or that has impact on end users, or (c) to train, fine tune, or distill other models for commercial use, in each case, is not a Non-Commercial Purpose.
+ - d. “Outputs” means any content generated by the operation of the FLUX Model or Derivatives from an input (such as an image input) or prompt (i.e., text instructions) provided by users. For the avoidance of doubt, Outputs do not include any components of the FLUX Model, such as any fine-tuned versions of the FLUX Model, the weights, or parameters.
+ - e.   “you” or “your” means the individual or entity entering into this License with Company.
+
+2. License Grant.
+- a. License. Subject to your compliance with this License, Company grants you a non-exclusive, worldwide, non-transferable, non-sublicensable, revocable, royalty free, and limited license to access, use, create Derivatives of, and Distribute the FLUX Model and Derivatives solely for your Non-Commercial Purposes. The foregoing license is personal to you, and you may not assign or sublicense this License or any other rights or obligations under this License without Company’s prior written consent; any such assignment or sublicense will be void and will automatically and immediately terminate this License.  Any restrictions set forth herein regarding the FLUX Model also apply to any Derivative you create or that are created on your behalf.
+- b. Non-Commercial Use Only.  You may only access, use, Distribute, or create Derivatives of the FLUX Model or Derivatives for Non-Commercial Purposes.  If you want to use a FLUX Model or a Derivative for any purpose that is not expressly authorized under this License, such as for a commercial activity, you must request a license from Company, which Company may grant to you in Company’s sole discretion and which additional use may be subject to a fee, royalty or other revenue share. Please see https://bfl.ai/licensing if you would like a commercial license.
+- c. Reserved Rights. The grant of rights expressly set forth in this License are the complete grant of rights to use the FLUX Model, and no other licenses are granted, whether by waiver, estoppel, implication, equity, or otherwise. Company and its licensors reserve all rights not expressly granted by this License.
+- d. Outputs. We claim no ownership rights in and to the Outputs. You are solely responsible for the Outputs you generate and their subsequent uses in accordance with this License. You may use Output for any purpose (including for commercial purposes), except as expressly prohibited herein. You may not use the Output to train, fine-tune, or distill a model that is competitive with a FLUX Model.
+- e. You may access, use, Distribute, or create Output of the FLUX Model or Derivatives if you: (i) (A) implement and maintain content filtering measures (“Content Filters”) for your use of the FLUX Model or Derivatives to prevent the creation, display, transmission, generation, or dissemination of unlawful or infringing content, which may include Content Filters that we may make available for use with the FLUX Model (“Provided Content Filters”), or (B) ensure Output undergoes review for unlawful or infringing content before public or non-public distribution, display, transmission or dissemination; and (ii) ensure Output includes disclosure (or other indication) that the Output was generated or modified using artificial intelligence technologies to the extent required under applicable law.
+
+3. Distribution. Subject to this License, you may Distribute copies of the FLUX Model and/or Derivatives made by you, under the following conditions:
+- a. you must make available a copy of this License to third-party recipients of the FLUX Mode and/or Derivatives you Distribute, and specify that any rights to use the FLUX Model and/or Derivatives shall be directly granted by Company to said third-party recipients pursuant to this License;
+- b. you must prominently display the following notice alongside the Distribution of the FLUX Model or Derivative (such as via a “Notice” text file distributed as part of such FLUX Model or Derivative) (the “Attribution Notice”):
+
+> This FLUX Model is licensed by Black Forest Labs Inc. under the FLUX Non-Commercial License. Copyright Black Forest Labs Inc. IN NO EVENT SHALL BLACK FOREST LABS INC. BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH USE OF THIS MODEL.
+
+- c. in the case of Distribution of Derivatives made by you: (i) you must also include in the Attribution Notice a statement that you have modified the applicable FLUX Model; (ii) any terms and conditions you impose on any third-party recipients relating to Derivatives made by or for you shall neither limit such third-party recipients’ use of the FLUX Model or any Derivatives made by or for Company in accordance with this License nor conflict with any of its terms and conditions and must include disclaimer of warranties and limitation of liability provisions that are at least as protective of Company as those set forth herein; and (iii) you must not misrepresent or imply, through any means, that the Derivatives made by or for you and/or any modified version of the FLUX Model you Distribute under your name and responsibility is an official product of the Company or has been endorsed, approved or validated by the Company, unless you are authorized by Company to do so in writing.
+
+4. Restrictions.  You will not, and will not permit, assist or cause any third party to
+- a. use, modify, copy, reproduce, create Derivatives of, or Distribute the FLUX Model (or any Derivative thereof, or any data produced by the FLUX Model), in whole or in part, (i) for any commercial or production purposes, (ii) military purposes, (iii) purposes of surveillance, including any research or development relating to surveillance, (iv) biometric processing, (v) in any manner that infringes, misappropriates, or otherwise violates (or is likely to infringe, misappropriate, or otherwise violate) any third party’s legal rights, including rights of publicity or “digital replica” rights, (vi) in any unlawful, fraudulent, defamatory, or abusive activity, (vii) to generate unlawful content, including child sexual abuse material, or non-consensual intimate images; or (viii) in any manner that violates any applicable law and any privacy or security laws, rules, regulations, directives, or governmental requirements (including the General Data Privacy Regulation (Regulation (EU) 2016/679), the California Consumer Privacy Act, any and all laws governing the processing of biometric information, and the EU Artificial Intelligence Act (Regulation (EU) 2024/1689), as well as all amendments and successor laws to any of the foregoing);
+  - b. alter or remove copyright and other proprietary notices which appear on or in any portion of the FLUX Model;
+  - c. utilize any equipment, device, software, or other means to circumvent or remove any security or protection used by Company in connection with the FLUX Model, or to circumvent or remove any usage restrictions, or to enable functionality disabled by FLUX  Model;
+  - d. offer or impose any terms on the FLUX Model that alter, restrict, or are inconsistent with the terms of this License;
+  - e. violate any applicable U.S. and non-U.S. export control and trade sanctions laws (“Export Laws”) in connection with your use or Distribution of any FLUX Model;
+  - f. directly or indirectly Distribute, export, or otherwise transfer FLUX Model (i) to any individual, entity, or country prohibited by Export Laws; (ii) to anyone on U.S. or non-U.S. government restricted parties lists; (iii) for any purpose prohibited by Export Laws, including nuclear, chemical or biological weapons, or missile technology applications; (iv) use or download FLUX Model if you or they are (a) located in a comprehensively sanctioned jurisdiction, (b) currently listed on any U.S. or non-U.S. restricted parties list, or (c) for any purpose prohibited by Export Laws; and (v) will not disguise your location through IP proxying or other methods.
+
+5. DISCLAIMERS.  THE FLUX MODEL AND PROVIDED CONTENT FILTERS ARE PROVIDED “AS IS” AND “WITH ALL FAULTS” WITH NO WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. COMPANY EXPRESSLY DISCLAIMS ALL REPRESENTATIONS AND WARRANTIES, EXPRESS OR IMPLIED, WHETHER BY STATUTE, CUSTOM, USAGE OR OTHERWISE AS TO ANY MATTERS RELATED TO THE FLUX MODEL AND PROVIDED CONTENT FILTERS, INCLUDING BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE, SATISFACTORY QUALITY, OR NON-INFRINGEMENT. COMPANY MAKES NO WARRANTIES OR REPRESENTATIONS THAT THE FLUX MODEL AND PROVIDED CONTENT FILTERS WILL BE ERROR FREE OR FREE OF VIRUSES OR OTHER HARMFUL COMPONENTS, OR PRODUCE ANY PARTICULAR RESULTS.
+
+6. LIMITATION OF LIABILITY.  TO THE FULLEST EXTENT PERMITTED BY LAW, IN NO EVENT WILL COMPANY BE LIABLE TO YOU OR YOUR EMPLOYEES, AFFILIATES, USERS, OFFICERS OR DIRECTORS (A) UNDER ANY THEORY OF LIABILITY, WHETHER BASED IN CONTRACT, TORT, NEGLIGENCE, STRICT LIABILITY, WARRANTY, OR OTHERWISE UNDER THIS LICENSE, OR (B) FOR ANY INDIRECT, CONSEQUENTIAL, EXEMPLARY, INCIDENTAL, PUNITIVE OR SPECIAL DAMAGES OR LOST PROFITS, EVEN IF COMPANY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. THE FLUX MODEL, ITS CONSTITUENT COMPONENTS, PROVIDED CONTENT FILTERS, AND ANY OUTPUT (COLLECTIVELY, “MODEL MATERIALS”) ARE NOT DESIGNED OR INTENDED FOR USE IN ANY APPLICATION OR SITUATION WHERE FAILURE OR FAULT OF THE MODEL MATERIALS COULD REASONABLY BE ANTICIPATED TO LEAD TO SERIOUS INJURY OF ANY PERSON, INCLUDING POTENTIAL DISCRIMINATION OR VIOLATION OF AN INDIVIDUAL’S PRIVACY RIGHTS, OR TO SEVERE PHYSICAL, PROPERTY, OR ENVIRONMENTAL DAMAGE (EACH, A “HIGH-RISK USE”). IF YOU ELECT TO USE ANY OF THE MODEL MATERIALS FOR A HIGH-RISK USE, YOU DO SO AT YOUR OWN RISK. YOU AGREE TO DESIGN AND IMPLEMENT APPROPRIATE DECISION-MAKING AND RISK-MITIGATION PROCEDURES AND POLICIES IN CONNECTION WITH A HIGH-RISK USE SUCH THAT EVEN IF THERE IS A FAILURE OR FAULT IN ANY OF THE MODEL MATERIALS, THE SAFETY OF PERSONS OR PROPERTY AFFECTED BY THE ACTIVITY STAYS AT A LEVEL THAT IS REASONABLE, APPROPRIATE, AND LAWFUL FOR THE FIELD OF THE HIGH-RISK USE.
+
+7. INDEMNIFICATION. You will indemnify, defend and hold harmless Company and our subsidiaries and affiliates, and each of our respective shareholders, directors, officers, employees, agents, successors, and assigns (collectively, the “Company Parties”) from and against any losses, liabilities, damages, fines, penalties, and expenses (including reasonable attorneys’ fees) incurred by any Company Party in connection with any claim, demand, allegation, lawsuit, proceeding, or investigation (collectively, “Claims”) arising out of or related to  (a) your access to or use of the FLUX Model (including in connection with any Output, results or data generated from such access or use, or from your access or use of any Content Filters), including any High-Risk Use; (b) your Content Filters, including your failure to implement any Content Filters where required by this License such as in Section 2(e); (c) your violation of this License; or (d) your violation, misappropriation or infringement of any rights of another (including intellectual property or other proprietary rights and privacy rights). You will promptly notify the Company Parties of any such Claims, and cooperate with Company Parties in defending such Claims. You will also grant the Company Parties sole control of the defense or settlement, at Company’s sole option, of any Claims. This indemnity is in addition to, and not in lieu of, any other indemnities or remedies set forth in a written agreement between you and Company or the other Company Parties.
+
+8. Termination; Survival.
+        a. This License will automatically terminate upon any breach by you of the terms of this License.
+        b. We may terminate this License, in whole or in part, at any time upon notice (including electronic) to you.
+        c. If you initiate any legal action or proceedings against Company or any other entity (including a cross-claim or counterclaim in a lawsuit), alleging that the FLUX Model, any Derivative, or Provided Content Filters, or any part thereof, infringe upon intellectual property or other rights owned or licensable by you, then any licenses granted to you under this License will immediately terminate as of the date such legal action or claim is filed or initiated.
+        d. Upon termination of this License, you must cease all use, access or Distribution of the FLUX Model, any Derivatives, and any Provided Content Filters.  The following sections survive termination of this License: 2(c), 2(d), 4-11.
+
+9. Third Party Materials. The FLUX Model and Provided Content Filters may contain third-party software or other components (including free and open source software) (all of the foregoing, “Third Party Materials”), which are subject to the license terms of the respective third-party licensors. Your dealings or correspondence with third parties and your use of or interaction with any Third Party Materials are solely between you and the third party. Company does not control or endorse, and makes no representations or warranties regarding, any Third Party Materials, and your access to and use of such Third Party Materials are at your own risk.
+
+10. Trademarks. You have not been granted any trademark license as part of this License and may not use any name, logo or trademark associated with Company without the prior written permission of Company, except to the extent necessary to make the reference required in the Attribution Notice as specified above or as is reasonably necessary in describing the FLUX Model and its creators.
+
+11. General. This License will be governed and construed under the laws of the State of Delaware without regard to conflicts of law provisions. If any provision or part of a provision of this License is unlawful, void or unenforceable, that provision or part of the provision is deemed severed from this License, and will not affect the validity and enforceability of any remaining provisions. The failure of Company to exercise or enforce any right or provision of this License will not operate as a waiver of such right or provision. This License does not confer any third-party beneficiary rights upon any other person or entity. This License, together with the documentation, contains the entire understanding between you and Company regarding the subject matter of this License, and supersedes all other written or oral agreements and understandings between you and Company regarding such subject matter.

LPC_FourDirection_Walk.safetensors

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:5e092a1451be9565862c491e58cfd85514869433570e85f2d2661ff613cbab6c
+size 126670920

LPC_FourDirection_Walk_ComfyUI.safetensors

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:272ed2f178dc205b016d5783757ff0ee7ddaec834f95bdd7fc061d08e3dc2afe
+size 126670832

NOTICE

@@ -0,0 +1,11 @@
+This distribution includes a derivative of FLUX.2 [klein] Base 9B.
+
+This FLUX Model is licensed by Black Forest Labs Inc. under the FLUX
+Non-Commercial License. Copyright Black Forest Labs Inc. IN NO EVENT SHALL
+BLACK FOREST LABS INC. BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR
+IN CONNECTION WITH USE OF THIS MODEL.
+
+Modified by Baragi AI as LPC Four-Direction Walk, a LoRA for LPC character
+and walking-sprite editing. This is not an official Black Forest Labs product
+and is not endorsed, approved, or validated by Black Forest Labs.

README.md

@@ -0,0 +1,213 @@
+---
+language:
+  - en
+license: other
+license_name: flux-non-commercial-license
+base_model: black-forest-labs/FLUX.2-klein-base-9B
+pipeline_tag: image-to-image
+library_name: diffusers
+tags:
+  - flux
+  - flux2
+  - lora
+  - image-editing
+  - pixel-art
+  - sprites
+  - lpc
+---
+
+# LPC Four-Direction Walk — FLUX.2 Klein 9B
+
+An experimental rank-16 LoRA for editing female LPC characters and 4×2
+walking sprite sheets with **FLUX.2 [klein] Base 9B**.
+
+## Supported tasks
+
+| Task token | Input | Output |
+|---|---|---|
+| `TASK_ROTATE_STANDING` | South-facing dressed character | Same character facing north, east, or west |
+| `TASK_STANDING_TO_WALK_FIRST_FRAME` | Standing character | First walking frame in the same direction |
+| `TASK_PROPAGATE_APPEARANCE` | 4×2 sheet with frame 1 dressed | The same appearance applied to frames 2–8 |
+| `TASK_DRESS_WALK_SHEET` | Female base 4×2 walk sheet | All eight frames dressed from a text description |
+| `TASK_DRESS_STANDING` | South-facing female base | Standing character dressed from a text description |
+
+Use the exact task token and sentence structure used during training:
+
+```text
+TASK_ROTATE_STANDING: Turn the south-facing standing female LPC character to face north. Preserve the exact hairstyle, hair color, clothing, shoes and accessories. Keep the character centered on a pure white background.
+```
+
+```text
+TASK_STANDING_TO_WALK_FIRST_FRAME: Convert this west-facing standing LPC character into the first frame of the west-facing walking animation. Preserve the exact appearance and pure white background.
+```
+
+```text
+TASK_PROPAGATE_APPEARANCE: Use frame 1 as the appearance reference. Apply exactly the same hairstyle, hair color, clothing, shoes and accessories to frames 2 through 8. Preserve every walking pose, frame order, 4 by 2 layout and pure white background.
+```
+
+```text
+TASK_DRESS_WALK_SHEET: Dress the female LPC character in all 8 east-facing walking frames with blue bob hair, a red long-sleeve shirt, navy pants, brown boots, and gold glasses. Preserve every pose, frame order, 4 by 2 layout and pure white background.
+```
+
+```text
+TASK_DRESS_STANDING: Dress the south-facing standing female LPC character with blue bob hair, a red long-sleeve shirt, navy pants, brown boots, and gold glasses. Preserve the pose and pure white background.
+```
+
+## Recommended inference settings
+
+- Base model: `black-forest-labs/FLUX.2-klein-base-9B`
+- LoRA strength: `1.0`
+- Steps: `28`
+- CFG: `5`
+- Sampler: Euler
+- Standing tasks: `1024×1024`
+- 4×2 sheet tasks: `2048×1024`
+- Background: white
+
+## ComfyUI workflow
+
+The workflow uses only ComfyUI core nodes and has been tested on Comfy Cloud.
+
+1. Install
+   [`LPC_FourDirection_Walk_ComfyUI.safetensors`](https://huggingface.co/Baragi-AI/LPC-FourDirection-Walk-Flux-Klein-9B/resolve/main/LPC_FourDirection_Walk_ComfyUI.safetensors)
+   as a LoRA.
+2. Import
+   [`workflows/LPC_FourDirection_Walk_ComfyUI.json`](workflows/LPC_FourDirection_Walk_ComfyUI.json).
+3. Select an input image and paste one of the task prompts above.
+4. Set `ImageScaleToTotalPixels` to `1.0` MP for standing/frame tasks or
+   `2.0` MP for 4×2 sheets.
+5. Generate with LoRA strength `1.0`, 28 steps, CFG `5`, and Euler.
+
+The graph uses:
+
+- `flux-2-klein-base-9b-fp8.safetensors`
+- `qwen_3_8b_fp8mixed.safetensors`
+- `full_encoder_small_decoder.safetensors`
+
+Keep the input reference latent connected to both positive and negative
+conditioning. This matches the official FLUX.2 Klein edit graph.
+
+An API-format version is available at
+[`workflows/LPC_FourDirection_Walk_API.json`](workflows/LPC_FourDirection_Walk_API.json).
+
+## GUI
+
+The included Korean-language Gradio workbench turns the five trained tasks
+into a guided character-production flow. It works with Comfy Cloud or a local
+ComfyUI server.
+
+```powershell
+python -m venv .venv
+.\.venv\Scripts\python -m pip install --upgrade pip
+.\.venv\Scripts\python -m pip install -r requirements.txt
+.\.venv\Scripts\python app.py
+```
+
+For Comfy Cloud, copy `.env.example` to `.env` and set:
+
+```dotenv
+COMFY_URL=https://cloud.comfy.org
+COMFY_API_KEY=your_api_key
+```
+
+The API key is read at runtime and is not written to the repository or output
+files.
+
+Use the virtual-environment commands above even if Anaconda `base` is active.
+Gradio 5.x imports the removed `huggingface_hub.HfFolder` API and is not
+supported by this GUI.
+
+### Guided workflow
+
+- **Quick build:** dress the bundled standing base, create selected standing
+  directions, and build each direction's 4×2 walking sheet stage by stage.
+  Run-all is a separate action and shows its Comfy job count first. Each stage
+  can be regenerated immediately with a new recorded seed.
+- **LoRA strength:** the always-visible shared slider applies `0`–`1.5` to
+  every generation task; `0` disables the LoRA and `1.0` is the default.
+- **Standing:** upload a character or start from the bundled female LPC base,
+  then create a dressed standing proof and its 32-color palette.
+- **Directions:** inspect north, west, south, and east standing results on one
+  turnaround board. Up to four direction jobs run concurrently, and each
+  result appears as soon as it finishes.
+- **Walking:** create a first walking frame, insert it into the matching
+  bundled 4×2 pose base, then propagate the appearance to all eight frames.
+  Each completed sheet gets an immediate looping animation preview.
+- **Pixel and palette:** snap to native LPC pixels, align 4×2 foot anchors,
+  lock or rebuild a 32-color palette, and export indexed PNG or GIF.
+- **Results and settings:** review local session outputs, test the Comfy
+  connection, tune generation settings, or access the exact English task
+  prompts in the advanced single-task panel.
+
+Generated files are saved under the ignored local `outputs/` directory. The
+bundled bases match the fixed feminine thin body and head used during training;
+other body types are outside this toy model's supported scope.
+
+### Pixel and palette output
+
+The GUI includes deterministic sprite post-processing:
+
+- **Lock reference palette:** maps every output pixel to the nearest color in
+  the input image or an optional shared palette-reference image. Select the
+  same reference for north, south, east, and west to keep one palette across
+  all directions.
+- **Allow new colors (32):** builds a new adaptive 32-color palette from the
+  generated result. Use this when the prompt adds hair, clothing, or
+  accessories whose colors are absent from the base.
+- **Align 4×2 frames:** detects the white background and aligns each
+  generated frame's foot anchor with the corresponding input frame.
+- **Pixel snap:** uses
+  [perfectPixel](https://github.com/theamusing/perfectPixel) to detect and
+  refine the generated pixel grid before optional nearest-neighbor upscaling.
+- **Shared direction palette:** once every selected direction is complete,
+  one 32-color palette is calculated from all completed images and applied
+  back to every direction without dithering.
+- **Resolution:** returns either native `64×64` single frames /
+  `256×128` 4×2 sheets or the generated upscaled resolution.
+- **Output:** returns an indexed PNG sheet or an eight-frame looping GIF.
+  GIF frames follow the 4×2 sheet in row-major order.
+
+Both palette modes write a 32-entry indexed palette without dithering. The
+background remains white.
+
+## Verified Comfy Cloud examples
+
+| Task | Input | Output |
+|---|---|---|
+| Dress standing character | ![Standing input](examples/standing_input.png) | ![Standing output](examples/cloud_t05_comfy_converted.png) |
+| Propagate frame 1 appearance | ![Propagation input](examples/propagate_input.png) | ![Propagation output](examples/cloud_t03_comfy_converted.png) |
+
+## Files
+
+- `LPC_FourDirection_Walk.safetensors`: original fal/PEFT format
+- `LPC_FourDirection_Walk_ComfyUI.safetensors`: ComfyUI-compatible key names
+- LoRA rank: 16
+- Tensors: 176, float32
+- Original SHA-256: `5e092a1451be9565862c491e58cfd85514869433570e85f2d2661ff613cbab6c`
+- ComfyUI SHA-256: `272ed2f178dc205b016d5783757ff0ee7ddaec834f95bdd7fc061d08e3dc2afe`
+
+Use the original file with fal. Use the `_ComfyUI` file with ComfyUI. The
+conversion only renames the fal PEFT prefix `base_model.model.` to ComfyUI's
+FLUX model prefix `diffusion_model.`; tensor values are unchanged. The
+reproducible converter is included as `convert_fal_lora_to_comfy.py`.
+
+## Limitations
+
+This is a toy-project LoRA trained on one female LPC body type. It may alter
+silhouettes, frame spacing, or poses, especially for appearances outside the
+training distribution. Generated sheets are not guaranteed to be
+pixel-perfect and may need alignment or nearest-neighbor cleanup.
+
+## License and attribution
+
+The weights are a derivative of FLUX.2 [klein] Base 9B and are distributed
+under the **FLUX Non-Commercial License v2.1**. Read `LICENSE.md` and `NOTICE`
+before downloading or using them. Commercial or production use of the model
+requires appropriate permission from Black Forest Labs.
+
+Training assets are derived from
+[ElizaWy/LPC](https://github.com/ElizaWy/LPC) and retain their respective LPC
+asset licenses and attribution requirements. See `THIRD_PARTY_NOTICES.txt`.
+
+This project is not affiliated with or endorsed by Black Forest Labs or the
+LPC contributors.

THIRD_PARTY_NOTICES.txt

@@ -0,0 +1,391 @@
+===== perfectPixel =====
+
+Source: https://github.com/theamusing/perfectPixel
+Package: perfect-pixel 0.1.4
+Copyright (c) theAmusing
+License: MIT
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+===== Characters/Credits.txt =====
+
+
+Adult Head - Feminine
+-------------------
+  ARTIST(S): Stephen Challener (Redshrike), Eliza Wyatt (DeathsDarling)
+  SOURCE: https://opengameart.org/content/liberated-pixel-cup-lpc-base-assets-sprites-map-tiles
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original by Stephen Challener. Edited to be smaller and recolored by Eliza Wyatt. Expressions by Eliza Wyatt.
+
+Adult Head - Masculine
+-------------------
+  ARTIST(S): Stephen Challener (Redshrike), Eliza Wyatt (DeathsDarling)
+  SOURCE: https://opengameart.org/content/liberated-pixel-cup-lpc-base-assets-sprites-map-tiles
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original by Stephen Challener. Edited to be smaller and recolored by Eliza Wyatt. Expressions by Eliza Wyatt.
+
+Adult Head - Elderly
+-------------------
+  ARTIST(S): Eliza Wyatt (DeathsDarling)
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original by Eliza Wyatt.
+
+Body - Feminine, Thin
+-------------------
+  ARTIST(S): Stephen Challener (Redshrike), Eliza Wyatt (DeathsDarling)
+  SOURCE: https://opengameart.org/content/liberated-pixel-cup-lpc-base-assets-sprites-map-tiles
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original design by Stephen Challener. Edits and recolors by Eliza Wyatt.
+  NOTES:
+	Idle Animation - Original static idle by Stephen Challener. Animated idle by Eliza Wyatt.
+	Walking Animation - Original by Stephen Challener. Edited by Eliza Wyatt.
+	Running Animation - Original by Eliza Wyatt.
+	Jumping Animation - Original by Durrani. Edited and recolored by Eliza Wyatt and BenCreating.
+	Climbing Animation - Original by Eliza Wyatt.
+	Emote Frames - Original by Eliza Wyatt.
+	Sitting Frames - Original by Eliza Wyatt.
+	Combat 1h (Idle, Slash, Halfslash, Backslash) - Original by Eliza Wyatt.
+	Legacy Swing - Original by Stephen Challener. Edited by Eliza Wyatt.
+
+Body - Masculine, Thin
+-------------------
+  ARTIST(S): Stephen Challener (Redshrike), Durrani, Eliza Wyatt (DeathsDarling), BenCreating
+  SOURCE: https://opengameart.org/content/liberated-pixel-cup-lpc-base-assets-sprites-map-tiles
+  SOURCE: https://opengameart.org/content/lpc-jump-expanded
+  LICENSE: OGA-BY 3.0
+  DETAILS: Originally the Feminine, Thin body by Stephen Challener. Altered by Eliza Wyatt. Edits and recolors by Eliza Wyatt.
+  NOTES:
+	Idle Animation - Original static idle by Stephen Challener. Animated idle by Eliza Wyatt.
+	Walking Animation - Original by Stephen Challener. Edited by Eliza Wyatt.
+	Running Animation - Original by Eliza Wyatt.
+	Jumping Animation - Original by Durrani. Edited and recolored by Eliza Wyatt and BenCreating.
+	Climbing Animation - Original by Eliza Wyatt.
+	Emote Frames - Original by Eliza Wyatt
+	Sitting Frames - Original by Eliza Wyatt
+	Combat 1h (Idle, Slash, Halfslash, Backslash) - Original by Eliza Wyatt.
+	Legacy Swing - Original by Stephen Challener. Edited by Eliza Wyatt.
+
+Wings 01 - Feathered Wings
+-------------------
+  ARTIST(S): Eliza Wyatt (DeathsDarling)
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original by Eliza Wyatt. Made to animate with the LPC body by Redshrike.
+
+===== Characters/Hair/Credits.txt =====
+
+All hair is based on the LPC body, by Stephen Challener (Redshrike).
+
+
+Medium 01 - Page
+--------------
+  ARTIST(S): Johannes Sjölund (Wulax), Eliza Wyatt (DeathsDarling)
+  SOURCE: https://opengameart.org/content/lpc-medieval-fantasy-character-sprites
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original by Johannes Sjölund. Edited, animated, and recolored by Eliza Wyatt.
+
+Medium 02 - Curly
+--------------
+  ARTIST(S): Eliza Wyatt (DeathsDarling)
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original by Eliza Wyatt.
+
+Medium 03 - Idol
+--------------
+  ARTIST(S): Thecilekli, Eliza Wyatt (DeathsDarling)
+  SOURCE: https://opengameart.org/content/lpc-korean-idol-hairstyle-male-with-12-colors
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original CC0 by Thecilekli. Edited, animated, and recolored by Eliza Wyatt.
+
+Medium 04 - Bangs & Bun
+--------------
+  ARTIST(S): BlueCarrot16, Eliza Wyatt (DeathsDarling)
+  SOURCE: https://opengameart.org/content/lpc-hair
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original CC0 by BlueCarrot16. Edited, animated, and recolored by Eliza Wyatt.
+
+Medium 05 - Cornrows
+--------------
+  ARTIST(S): BlueCarrot16, Eliza Wyatt (DeathsDarling)
+  SOURCE: https://opengameart.org/content/lpc-hair
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original CC0 by BlueCarrot16. Edited, animated, and recolored by Eliza Wyatt.
+
+Medium 06 - Dreadlocks
+--------------
+  ARTIST(S): BlueCarrot16, Eliza Wyatt (DeathsDarling)
+  SOURCE: https://opengameart.org/content/lpc-hair
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original "Short Dreadlocks" CC0 by BlueCarrot16. Edited, animated, and recolored by Eliza Wyatt.
+
+Medium 07 - Bob, Side Part
+--------------
+  ARTIST(S): BlueCarrot16, Eliza Wyatt (DeathsDarling)
+  SOURCE: https://opengameart.org/content/lpc-hair
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original CC0 by Thecilekli. Touchups by BlueCarrot16. Edited, animated, and recolored by Eliza Wyatt.
+
+Medium 08 - Bob, Bangs
+--------------
+  ARTIST(S): BlueCarrot16, Eliza Wyatt (DeathsDarling)
+  SOURCE: https://opengameart.org/content/lpc-hair
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original CC0 by BlueCarrot16. Edited, animated, and recolored by Eliza Wyatt.
+
+Medium 09 - Twists
+--------------
+  ARTIST(S): BlueCarrot16, Eliza Wyatt (DeathsDarling)
+  SOURCE: https://opengameart.org/content/lpc-hair
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original CC0 by BlueCarrot16. Edited, animated, and recolored by Eliza Wyatt.
+
+Medium 10 - Twists, Fade
+--------------
+  ARTIST(S): BlueCarrot16, Eliza Wyatt (DeathsDarling)
+  SOURCE: https://opengameart.org/content/lpc-hair
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original CC0 by BlueCarrot16. Edited, animated, and recolored by Eliza Wyatt.
+
+Short 01 - Buzzcut
+--------------
+  ARTIST(S): Eliza Wyatt (DeathsDarling)
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original by Eliza Wyatt.
+
+Short 02 - Parted
+--------------
+  ARTIST(S): Eliza Wyatt (DeathsDarling)
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original by Eliza Wyatt.
+
+Short 03 - Curly
+--------------
+  ARTIST(S): Eliza Wyatt (DeathsDarling)
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original by Eliza Wyatt.
+
+Short 04 - Cowlick
+--------------
+  ARTIST(S): BlueCarrot16, Eliza Wyatt (DeathsDarling)
+  SOURCE: https://opengameart.org/content/lpc-hair
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original CC0 by BlueCarrot16. Edited, animated, and recolored by Eliza Wyatt.
+
+Short 05 - Natural
+--------------
+  ARTIST(S): BlueCarrot16, Eliza Wyatt (DeathsDarling)
+  SOURCE: https://opengameart.org/content/lpc-hair
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original CC0 by BlueCarrot16. Edited, animated, and recolored by Eliza Wyatt.
+
+Short 06 - Balding
+--------------
+  ARTIST(S): Eliza Wyatt (DeathsDarling)
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original by Eliza Wyatt.
+
+Short 07 - Flat Top
+--------------
+  ARTIST(S): BlueCarrot16, Eliza Wyatt (DeathsDarling)
+  SOURCE: https://opengameart.org/content/lpc-hair
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original CC0 by BlueCarrot16. Edited, animated, and recolored by Eliza Wyatt.
+
+Short 08 - Flat Top, Fade
+--------------
+  ARTIST(S): BlueCarrot16, Eliza Wyatt (DeathsDarling)
+  SOURCE: https://opengameart.org/content/lpc-hair
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original CC0 by BlueCarrot16. Edited, animated, and recolored by Eliza Wyatt.
+
+===== Characters/Clothing/Credits.txt =====
+
+All clothing is based on the original LPC body and animations, which were designed by Stephen Challener (Redshrike) and expanded by Eliza Wyatt (DeathsDarling), Durrani, and BenCreating.
+
+
+--- Accessories ---
+
+Neckwear 01 - Bowtie
+--------------
+  ARTIST(S): Eliza Wyatt (DeathsDarling)
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original by Eliza Wyatt.
+
+
+
+--- TORSO ---
+
+Shirt 01 - Longsleeve Shirt
+--------------
+  ARTIST(S): Eliza Wyatt (DeathsDarling)
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original by Eliza Wyatt.
+
+Shirt 02 - V-neck Longsleeve Shirt
+--------------
+  ARTIST(S): Eliza Wyatt (DeathsDarling)
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original by Eliza Wyatt.
+
+Shirt 03 - Scoop Longsleeve Shirt
+--------------
+  ARTIST(S): Eliza Wyatt (DeathsDarling)
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original by Eliza Wyatt.
+
+Shirt 04 - T-shirt
+--------------
+  ARTIST(S): Eliza Wyatt (DeathsDarling)
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original by Eliza Wyatt.
+
+Shirt 05 - V-neck T-shirt
+--------------
+  ARTIST(S): Eliza Wyatt (DeathsDarling)
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original by Eliza Wyatt.
+
+Shirt 06 - Scoop T-shirt
+--------------
+  ARTIST(S): Eliza Wyatt (DeathsDarling)
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original by Eliza Wyatt.
+
+Shirt 07 - Buttoned Longsleeve Shirt
+--------------
+  ARTIST(S): Eliza Wyatt (DeathsDarling)
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original by Eliza Wyatt.
+
+Shirt 08 - Buttoned T-shirt
+--------------
+  ARTIST(S): Eliza Wyatt (DeathsDarling)
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original by Eliza Wyatt.
+
+Shirt 09 - Polo
+--------------
+  ARTIST(S): Eliza Wyatt (DeathsDarling)
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original by Eliza Wyatt.
+
+
+
+--- TORSO 2 ---
+
+Accessory 01 - Suspenders
+--------------
+  ARTIST(S): Eliza Wyatt (DeathsDarling)
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original by Eliza Wyatt.
+
+Sweater 01 - Cardigan
+--------------
+  ARTIST(S): Eliza Wyatt (DeathsDarling)
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original by Eliza Wyatt.
+
+
+
+--- LEGS ---
+
+Pants 01 - Hose
+--------------
+  ARTIST(S): Eliza Wyatt (DeathsDarling)
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original by Eliza Wyatt.
+
+Pants 02 - Leggings
+--------------
+  ARTIST(S): Eliza Wyatt (DeathsDarling)
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original by Eliza Wyatt.
+
+Pants 03 - Pants
+--------------
+  ARTIST(S): Eliza Wyatt (DeathsDarling)
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original by Eliza Wyatt.
+
+Pants 04 - Cuffed Pants
+--------------
+  ARTIST(S): Eliza Wyatt (DeathsDarling)
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original by Eliza Wyatt.
+
+Pants 05 - Overalls
+--------------
+  ARTIST(S): Eliza Wyatt (DeathsDarling)
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original by Eliza Wyatt.
+
+Shorts 01 - Shorts
+--------------
+  ARTIST(S): Eliza Wyatt (DeathsDarling)
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original by Eliza Wyatt.
+
+Shorts 02 - Short Shorts
+--------------
+  ARTIST(S): Eliza Wyatt (DeathsDarling)
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original by Eliza Wyatt.
+
+
+
+--- FEET ---
+
+Shoes 01 - Shoes
+--------------
+  ARTIST(S): Eliza Wyatt (DeathsDarling)
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original by Eliza Wyatt.
+
+Shoes 02 - Boots
+--------------
+  ARTIST(S): Eliza Wyatt (DeathsDarling)
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original by Eliza Wyatt.
+
+Socks 01 - Ankle Socks
+--------------
+  ARTIST(S): Eliza Wyatt (DeathsDarling)
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original by Eliza Wyatt.
+
+Socks 02 - High Socks
+--------------
+  ARTIST(S): Eliza Wyatt (DeathsDarling)
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original by Eliza Wyatt.
+
+
+===== Characters/Head Accessories/Credits.txt =====
+
+Glasses, Halfmoon Glasses
+-------------------
+  ARTIST(S): Eliza Wyatt (DeathsDarling)
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original by Eliza Wyatt.
+
+
+Helms 1-6 (Bascinet, Normal, Chainmail Hood, Kettle Helm, Morion, & Associated Plumage)
+-------------------
+  ARTIST(S): Eliza Wyatt (DeathsDarling)
+  LICENSE: OGA-BY 3.0
+  DETAILS: Original by Eliza Wyatt.

app.py

@@ -0,0 +1,2185 @@
+# THESIS: Turn five model tasks into one character-to-animation workbench;
+# refuse the generic prompt form as the product's primary structure.
+# OWN-WORLD: White proof sheets, near-black ink rails, cobalt registration
+# marks, vermilion actions, square frame cells, and indexed palette strips.
+# STORY: Choose a real LPC base, dress it, derive directions and walks, correct
+# pixels and palette, then export; every result becomes the next stage's input.
+# FIRST VIEWPORT: Source rail left, dominant active proof center, next action
+# right, with the palette and proof log below.
+# FORM: Screenprint registration workbench; staged per tab from approved comps
+# A+B+C. Direction seed e120291a.
+
+import argparse
+import copy
+import json
+import os
+import secrets
+import shutil
+import tempfile
+import time
+from concurrent.futures import ThreadPoolExecutor, as_completed
+from datetime import datetime
+from pathlib import Path
+from urllib.parse import urlsplit, urlunsplit
+
+import gradio as gr
+import requests
+from dotenv import load_dotenv
+from PIL import Image, ImageDraw
+
+from postprocess import (
+    apply_shared_palette,
+    process_output,
+    reference_palette,
+    save_gif,
+    shared_palette,
+)
+
+
+ROOT = Path(__file__).parent
+WORKFLOW = ROOT / "workflows" / "LPC_FourDirection_Walk_API.json"
+BASE_DIR = ROOT / "assets" / "bases"
+OUTPUT_DIR = ROOT / "outputs"
+BASE_STANDING = BASE_DIR / "standing_south.png"
+BASE_WALKS = {
+    "north": BASE_DIR / "walk_north_4x2.png",
+    "west": BASE_DIR / "walk_west_4x2.png",
+    "south": BASE_DIR / "walk_south_4x2.png",
+    "east": BASE_DIR / "walk_east_4x2.png",
+}
+DIRECTIONS = ("north", "west", "south", "east")
+MAX_PARALLEL_REQUESTS = 4
+DIRECTION_LABELS = {
+    "north": "북쪽",
+    "west": "서쪽",
+    "south": "남쪽",
+    "east": "동쪽",
+}
+
+
+def load_environment():
+    for directory in (ROOT, *ROOT.parents):
+        candidate = directory / ".env"
+        if candidate.exists():
+            load_dotenv(candidate, override=False)
+            return candidate
+    return None
+
+
+ENV_PATH = load_environment()
+
+TASKS = {
+    "Rotate standing character": (
+        "TASK_ROTATE_STANDING: Turn the south-facing standing female LPC "
+        "character to face {direction}. Preserve the exact hairstyle, hair "
+        "color, clothing, shoes and accessories. Keep the character centered "
+        "on a pure white background."
+    ),
+    "Standing to walk frame 1": (
+        "TASK_STANDING_TO_WALK_FIRST_FRAME: Convert this {direction}-facing "
+        "standing LPC character into the first frame of the {direction}-facing "
+        "walking animation. Preserve the exact appearance and pure white background."
+    ),
+    "Propagate frame 1 appearance": (
+        "TASK_PROPAGATE_APPEARANCE: Use frame 1 as the appearance reference. "
+        "Apply exactly the same hairstyle, hair color, clothing, shoes and "
+        "accessories to frames 2 through 8. Preserve every walking pose, frame "
+        "order, 4 by 2 layout and pure white background."
+    ),
+    "Dress 4x2 walk sheet": (
+        "TASK_DRESS_WALK_SHEET: Dress the female LPC character in all 8 "
+        "{direction}-facing walking frames with {appearance}. Preserve every "
+        "pose, frame order, 4 by 2 layout and pure white background."
+    ),
+    "Dress standing character": (
+        "TASK_DRESS_STANDING: Dress the south-facing standing female LPC "
+        "character with {appearance}. Preserve the pose and pure white background."
+    ),
+}
+TASK_LABELS = {
+    "Rotate standing character": "Standing 방향 바꾸기",
+    "Standing to walk frame 1": "걷기 첫 프레임 만들기",
+    "Propagate frame 1 appearance": "첫 프레임 외형 전파",
+    "Dress 4x2 walk sheet": "4×2 걷기 시트 단장",
+    "Dress standing character": "Standing 캐릭터 단장",
+}
+PALETTE_CHOICES = [
+    ("기준 팔레트 고정", "Lock reference palette"),
+    ("새 색상 허용 · 최종 32색", "Allow new colors (32)"),
+]
+RESOLUTION_CHOICES = [
+    ("업스케일 유지", "Upscaled"),
+    ("LPC 원본 크기", "Native LPC"),
+]
+FORMAT_CHOICES = [
+    ("PNG 시트", "PNG sheet"),
+    ("GIF 애니메이션", "GIF"),
+]
+
+
+def initial_state():
+    return {
+        "active_standing": "",
+        "active_palette": "",
+        "directions": {},
+        "walks": {},
+        "history": [],
+    }
+
+
+def state_copy(state):
+    return copy.deepcopy(state) if state else initial_state()
+
+
+def make_prompt(task, direction, appearance):
+    if task not in TASKS:
+        raise ValueError(f"알 수 없는 작업입니다: {task}")
+    if task.startswith("Dress") and not appearance.strip():
+        raise ValueError("머리, 옷, 신발, 장식을 설명해 주세요.")
+    return TASKS[task].format(
+        direction=direction.lower(), appearance=appearance.strip()
+    )
+
+
+def normalize_server(value):
+    raw = (value or "").strip()
+    if not raw:
+        raise ValueError("ComfyUI 서버 주소를 입력해 주세요.")
+    if raw.count("://") != 1:
+        raise ValueError(
+            "서버 주소가 중복되었거나 형식이 잘못되었습니다. "
+            "예: https://cloud.comfy.org"
+        )
+    parsed = urlsplit(raw)
+    if parsed.scheme not in {"http", "https"} or not parsed.hostname:
+        raise ValueError("서버 주소는 http:// 또는 https://로 시작해야 합니다.")
+    clean = parsed._replace(query="", fragment="")
+    return urlunsplit(clean).rstrip("/")
+
+
+def resolve_api_key(value):
+    return (
+        (value or "").strip()
+        or os.getenv("COMFY_API_KEY", "").strip()
+        or os.getenv("COMFY_CLOUD_API_KEY", "").strip()
+    )
+
+
+def is_cloud(server):
+    return urlsplit(server).hostname == "cloud.comfy.org"
+
+
+def headers(api_key):
+    return {"X-API-Key": api_key} if api_key else {}
+
+
+def request_error(error):
+    if isinstance(error, requests.exceptions.ConnectionError):
+        return (
+            "서버에 연결하지 못했습니다. 주소가 중복 입력되지 않았는지와 "
+            "인터넷 연결을 확인해 주세요."
+        )
+    if isinstance(error, requests.exceptions.Timeout):
+        return "서버 응답 시간이 초과되었습니다. 잠시 후 다시 시도해 주세요."
+    if isinstance(error, requests.exceptions.HTTPError):
+        status = error.response.status_code if error.response is not None else "알 수 없음"
+        if status in {401, 403}:
+            return "API 키가 거부되었습니다. Comfy Cloud 키를 다시 확인해 주세요."
+        return f"ComfyUI가 HTTP {status} 오류를 반환했습니다."
+    return str(error)
+
+
+def upload_image(server, api_key, image_path):
+    with open(image_path, "rb") as image:
+        response = requests.post(
+            f"{server}/api/upload/image",
+            headers=headers(api_key),
+            files={"image": (Path(image_path).name, image, "image/png")},
+            data={"type": "input", "overwrite": "true"},
+            timeout=120,
+        )
+    response.raise_for_status()
+    return response.json()["name"]
+
+
+def submit(server, api_key, workflow):
+    response = requests.post(
+        f"{server}/api/prompt",
+        headers=headers(api_key),
+        json={"prompt": workflow},
+        timeout=120,
+    )
+    response.raise_for_status()
+    data = response.json()
+    return data.get("prompt_id") or data["job_id"]
+
+
+def first_image(value):
+    if isinstance(value, dict):
+        if {"filename", "type"} <= value.keys():
+            return value
+        for child in value.values():
+            found = first_image(child)
+            if found:
+                return found
+    elif isinstance(value, list):
+        for child in value:
+            found = first_image(child)
+            if found:
+                return found
+    return None
+
+
+def wait_for_result(server, api_key, job_id, cloud):
+    deadline = time.time() + 900
+    while time.time() < deadline:
+        if cloud:
+            response = requests.get(
+                f"{server}/api/jobs/{job_id}",
+                headers=headers(api_key),
+                timeout=60,
+            )
+            response.raise_for_status()
+            data = response.json()
+            status = data.get("status")
+            if status == "completed":
+                return data
+            if status in {"failed", "cancelled"}:
+                raise RuntimeError(data.get("error") or f"작업이 {status} 상태입니다.")
+        else:
+            response = requests.get(
+                f"{server}/api/history/{job_id}",
+                headers=headers(api_key),
+                timeout=60,
+            )
+            response.raise_for_status()
+            data = response.json()
+            if job_id in data:
+                return data[job_id]
+        time.sleep(2)
+    raise TimeoutError("15분 안에 생성이 완료되지 않았습니다.")
+
+
+def download_image(server, api_key, output):
+    response = requests.get(
+        f"{server}/api/view",
+        headers=headers(api_key),
+        params={
+            "filename": output["filename"],
+            "subfolder": output.get("subfolder", ""),
+            "type": output.get("type", "output"),
+        },
+        timeout=120,
+    )
+    response.raise_for_status()
+    with tempfile.NamedTemporaryFile(delete=False, suffix=".png") as handle:
+        handle.write(response.content)
+        return handle.name
+
+
+def persist(path, prefix):
+    OUTPUT_DIR.mkdir(exist_ok=True)
+    source = Path(path)
+    stamp = datetime.now().strftime("%Y%m%d_%H%M%S_%f")
+    target = OUTPUT_DIR / f"{prefix}_{stamp}{source.suffix.lower()}"
+    shutil.copy2(source, target)
+    return str(target)
+
+
+def add_history(state, path, label):
+    state["history"].insert(0, {"path": path, "label": label})
+    state["history"] = state["history"][:24]
+
+
+def history_value(state):
+    return [
+        (entry["path"], entry["label"])
+        for entry in (state or {}).get("history", [])
+        if Path(entry["path"]).exists()
+    ]
+
+
+def direction_values(state):
+    directions = (state or {}).get("directions", {})
+    return tuple(directions.get(direction) for direction in DIRECTIONS)
+
+
+def walk_value(state):
+    walks = (state or {}).get("walks", {})
+    return [
+        (walks[direction], f"{DIRECTION_LABELS[direction]} 걷기")
+        for direction in DIRECTIONS
+        if direction in walks and Path(walks[direction]).exists()
+    ]
+
+
+def palette_swatch(colors, prefix="palette"):
+    while len(colors) < 32:
+        colors.append(colors[-1])
+    swatch = 34
+    preview = Image.new("RGB", (swatch * 16, swatch * 2), "white")
+    draw = ImageDraw.Draw(preview)
+    for index, color in enumerate(colors[:32]):
+        x = (index % 16) * swatch
+        y = (index // 16) * swatch
+        draw.rectangle((x, y, x + swatch - 2, y + swatch - 2), fill=color)
+    with tempfile.NamedTemporaryFile(delete=False, suffix=".png") as handle:
+        preview.save(handle.name)
+        return persist(handle.name, prefix)
+
+
+def palette_preview(image_path, prefix="palette"):
+    image = Image.open(image_path).convert("RGB").resize(
+        (64, 64), Image.Resampling.NEAREST
+    )
+    return palette_swatch(reference_palette(image), prefix)
+
+
+def finalize_shared_palette(paths, prefix):
+    colors = shared_palette(paths.values())
+    outputs = apply_shared_palette(paths.values(), colors)
+    finalized = {
+        direction: persist(path, f"{prefix}_{direction}")
+        for direction, path in zip(paths, outputs)
+    }
+    return finalized, palette_swatch(colors, f"{prefix}_palette")
+
+
+def animation_preview(sheet_path, fps=8):
+    sheet = Image.open(sheet_path).convert("RGB")
+    return persist(
+        save_gif(sheet, reference_palette(sheet), fps),
+        "walk_preview",
+    )
+
+
+def generate(
+    server_value,
+    api_key_value,
+    image_path,
+    task,
+    direction,
+    appearance,
+    seed,
+    steps,
+    cfg,
+    lora_strength,
+    palette_reference_path=None,
+    palette_mode="Lock reference palette",
+    align_frames=True,
+    pixel_snap=True,
+    output_resolution="Upscaled",
+    output_format="PNG sheet",
+    fps=8,
+    prefix="result",
+):
+    if not image_path:
+        raise ValueError("입력 이미지를 선택해 주세요.")
+    server = normalize_server(server_value)
+    api_key = resolve_api_key(api_key_value)
+    cloud = is_cloud(server)
+    if cloud and not api_key:
+        raise ValueError(
+            "Comfy Cloud API 키가 필요합니다. 설정 탭 또는 .env에 "
+            "COMFY_API_KEY를 입력해 주세요."
+        )
+
+    workflow = json.loads(WORKFLOW.read_text(encoding="utf-8"))
+    workflow["1"]["inputs"]["image"] = upload_image(server, api_key, image_path)
+    workflow["4"]["inputs"]["strength_model"] = float(lora_strength)
+    workflow["9"]["inputs"]["text"] = make_prompt(task, direction, appearance)
+    workflow["14"]["inputs"]["noise_seed"] = int(seed)
+    workflow["15"]["inputs"]["steps"] = int(steps)
+    workflow["17"]["inputs"]["cfg"] = float(cfg)
+    workflow["2"]["inputs"]["megapixels"] = (
+        2.0 if task in {"Dress 4x2 walk sheet", "Propagate frame 1 appearance"} else 1.0
+    )
+
+    job_id = submit(server, api_key, workflow)
+    result = wait_for_result(server, api_key, job_id, cloud)
+    output = first_image(result.get("outputs", result))
+    if not output:
+        raise RuntimeError("ComfyUI 작업은 끝났지만 이미지 출력이 없습니다.")
+    raw_path = download_image(server, api_key, output)
+    final_path = process_output(
+        raw_path,
+        image_path,
+        task,
+        palette_reference_path,
+        palette_mode,
+        align_frames,
+        pixel_snap,
+        output_resolution,
+        output_format,
+        fps,
+    )
+    return persist(final_path, prefix), job_id
+
+
+def compose_first_frame(first_frame_path, direction):
+    base = Image.open(BASE_WALKS[direction]).convert("RGB")
+    first = Image.open(first_frame_path).convert("RGB").resize(
+        (base.width // 4, base.height // 2), Image.Resampling.NEAREST
+    )
+    base.paste(first, (0, 0))
+    with tempfile.NamedTemporaryFile(delete=False, suffix=".png") as handle:
+        base.save(handle.name)
+        return handle.name
+
+
+def dress_core(
+    source,
+    appearance,
+    server,
+    api_key,
+    seed,
+    steps,
+    cfg,
+    strength,
+    state,
+):
+    final, job_id = generate(
+        server,
+        api_key,
+        source,
+        "Dress standing character",
+        "south",
+        appearance,
+        seed,
+        steps,
+        cfg,
+        strength,
+        palette_mode="Allow new colors (32)",
+        align_frames=False,
+        prefix="standing_dressed",
+    )
+    state = state_copy(state)
+    palette = palette_preview(final)
+    state["active_standing"] = final
+    state["active_palette"] = palette
+    state["directions"] = {"south": final}
+    state["walks"] = {}
+    add_history(state, final, "Standing 외형 완료")
+    return state, final, palette, job_id
+
+
+def direction_job(
+    direction,
+    index,
+    source,
+    server,
+    api_key,
+    seed,
+    steps,
+    cfg,
+    strength,
+):
+    if direction == "south":
+        return source, "기존 Standing 사용"
+    return generate(
+        server,
+        api_key,
+        source,
+        "Rotate standing character",
+        direction,
+        "",
+        int(seed) + index,
+        steps,
+        cfg,
+        strength,
+        palette_mode="Defer shared palette",
+        prefix=f"standing_{direction}_pending",
+    )
+
+
+def direction_results(
+    selected,
+    source,
+    server,
+    api_key,
+    seed,
+    steps,
+    cfg,
+    strength,
+    state,
+    progress=None,
+):
+    state = state if state is not None else initial_state()
+    source = source or state.get("active_standing")
+    if not source:
+        raise ValueError("먼저 Standing 캐릭터를 완성해 주세요.")
+    selected = list(dict.fromkeys(selected or []))
+    if not selected:
+        raise ValueError("생성할 방향을 하나 이상 선택해 주세요.")
+    for direction in selected:
+        state["directions"].pop(direction, None)
+    total = len(selected)
+    completed = 0
+    failures = []
+    workers = min(MAX_PARALLEL_REQUESTS, total)
+    with ThreadPoolExecutor(max_workers=workers) as executor:
+        futures = {
+            executor.submit(
+                direction_job,
+                direction,
+                index,
+                source,
+                server,
+                api_key,
+                seed,
+                steps,
+                cfg,
+                strength,
+            ): direction
+            for index, direction in enumerate(selected)
+        }
+        for future in as_completed(futures):
+            direction = futures[future]
+            try:
+                final, job_id = future.result()
+            except Exception as error:
+                failures.append(f"{DIRECTION_LABELS[direction]}: {request_error(error)}")
+                continue
+            state["directions"][direction] = final
+            completed += 1
+            add_history(
+                state,
+                final,
+                f"{DIRECTION_LABELS[direction]} Standing · 팔레트 대기 · {job_id}",
+            )
+            if progress:
+                progress(
+                    (completed, total),
+                    desc=f"{DIRECTION_LABELS[direction]} 완료 · {completed}/{total}",
+                )
+            yield state, f"{DIRECTION_LABELS[direction]} 완료 · {completed}/{total}"
+
+    if failures:
+        raise RuntimeError(" / ".join(failures))
+
+    finalized, palette = finalize_shared_palette(
+        {direction: state["directions"][direction] for direction in selected},
+        "standing_shared",
+    )
+    state["directions"].update(finalized)
+    state["active_palette"] = palette
+    if "south" in finalized:
+        state["active_standing"] = finalized["south"]
+    for direction, path in finalized.items():
+        add_history(state, path, f"{DIRECTION_LABELS[direction]} Standing · 공통 팔레트")
+    if progress:
+        progress(1, desc="전체 방향 공통 32색 팔레트 적용")
+    yield state, "전체 방향 완료 · 공통 32색 팔레트를 적용했습니다."
+
+
+def walk_job(
+    direction,
+    index,
+    standing,
+    server,
+    api_key,
+    seed,
+    steps,
+    cfg,
+    strength,
+):
+    first, _ = generate(
+        server,
+        api_key,
+        standing,
+        "Standing to walk frame 1",
+        direction,
+        "",
+        int(seed) + index * 2,
+        steps,
+        cfg,
+        strength,
+        palette_mode="Defer shared palette",
+        align_frames=False,
+        prefix=f"walk_first_{direction}_pending",
+    )
+    composite = compose_first_frame(first, direction)
+    final, job_id = generate(
+        server,
+        api_key,
+        composite,
+        "Propagate frame 1 appearance",
+        direction,
+        "",
+        int(seed) + index * 2 + 1,
+        steps,
+        cfg,
+        strength,
+        palette_mode="Defer shared palette",
+        align_frames=True,
+        prefix=f"walk_{direction}_pending",
+    )
+    return final, job_id
+
+
+def walk_results(
+    selected,
+    server,
+    api_key,
+    seed,
+    steps,
+    cfg,
+    strength,
+    state,
+    progress=None,
+):
+    state = state if state is not None else initial_state()
+    selected = list(dict.fromkeys(selected or []))
+    if not selected:
+        raise ValueError("생성할 방향을 하나 이상 선택해 주세요.")
+    missing = [
+        direction
+        for direction in selected
+        if direction not in state.get("directions", {})
+    ]
+    if missing:
+        labels = ", ".join(DIRECTION_LABELS[direction] for direction in missing)
+        raise ValueError(f"먼저 다음 방향의 Standing을 만들어 주세요: {labels}")
+    for direction in selected:
+        state["walks"].pop(direction, None)
+
+    total = len(selected)
+    completed = 0
+    failures = []
+    workers = min(MAX_PARALLEL_REQUESTS, total)
+    with ThreadPoolExecutor(max_workers=workers) as executor:
+        futures = {
+            executor.submit(
+                walk_job,
+                direction,
+                index,
+                state["directions"][direction],
+                server,
+                api_key,
+                seed,
+                steps,
+                cfg,
+                strength,
+            ): direction
+            for index, direction in enumerate(selected)
+        }
+        for future in as_completed(futures):
+            direction = futures[future]
+            try:
+                final, job_id = future.result()
+            except Exception as error:
+                failures.append(f"{DIRECTION_LABELS[direction]}: {request_error(error)}")
+                continue
+            state["walks"][direction] = final
+            completed += 1
+            add_history(
+                state,
+                final,
+                f"{DIRECTION_LABELS[direction]} 걷기 · 팔레트 대기 · {job_id}",
+            )
+            if progress:
+                progress(
+                    (completed, total),
+                    desc=f"{DIRECTION_LABELS[direction]} 걷기 완료 · {completed}/{total}",
+                )
+            yield state, f"{DIRECTION_LABELS[direction]} 걷기 완료 · {completed}/{total}"
+
+    if failures:
+        raise RuntimeError(" / ".join(failures))
+
+    finalized, palette = finalize_shared_palette(
+        {direction: state["walks"][direction] for direction in selected},
+        "walk_shared",
+    )
+    state["walks"].update(finalized)
+    state["active_palette"] = palette
+    for direction, path in finalized.items():
+        add_history(state, path, f"{DIRECTION_LABELS[direction]} 걷기 · 공통 팔레트")
+    if progress:
+        progress(1, desc="전체 방향 공통 32색 팔레트 적용")
+    yield state, "전체 걷기 완료 · 공통 32색 팔레트를 적용했습니다."
+
+
+def format_failure(error):
+    return f"오류 · {request_error(error)}"
+
+
+def ui_dress(
+    source,
+    appearance,
+    server,
+    api_key,
+    seed,
+    steps,
+    cfg,
+    strength,
+    state,
+):
+    try:
+        state, final, palette, job_id = dress_core(
+            source,
+            appearance,
+            server,
+            api_key,
+            seed,
+            steps,
+            cfg,
+            strength,
+            state,
+        )
+        return (
+            final,
+            palette,
+            final,
+            f"완료 · Standing 외형 생성 · 시드 {int(seed)} · {job_id}",
+            state,
+            history_value(state),
+        )
+    except Exception as error:
+        return None, None, None, format_failure(error), state, history_value(state)
+
+
+def ui_directions(
+    selected,
+    source,
+    server,
+    api_key,
+    seed,
+    steps,
+    cfg,
+    strength,
+    state,
+    progress=gr.Progress(),
+):
+    try:
+        for state, message in direction_results(
+            selected,
+            source,
+            server,
+            api_key,
+            seed,
+            steps,
+            cfg,
+            strength,
+            state,
+            progress,
+        ):
+            yield (
+                *direction_values(state),
+                f"{message} · 시드 {int(seed)}",
+                state,
+                history_value(state),
+            )
+    except Exception as error:
+        yield (
+            *direction_values(state),
+            format_failure(error),
+            state,
+            history_value(state),
+        )
+
+
+def ui_walks(
+    selected,
+    server,
+    api_key,
+    seed,
+    steps,
+    cfg,
+    strength,
+    state,
+    progress=gr.Progress(),
+):
+    try:
+        for state, message in walk_results(
+            selected,
+            server,
+            api_key,
+            seed,
+            steps,
+            cfg,
+            strength,
+            state,
+            progress,
+        ):
+            available = [
+                state["walks"][direction]
+                for direction in selected or []
+                if direction in state["walks"]
+            ]
+            latest = available[-1] if available else None
+            animation = animation_preview(latest) if latest else None
+            yield (
+                walk_value(state),
+                latest,
+                animation,
+                latest,
+                f"{message} · 시드 {int(seed)}",
+                state,
+                history_value(state),
+            )
+    except Exception as error:
+        yield (
+            walk_value(state),
+            None,
+            None,
+            None,
+            format_failure(error),
+            state,
+            history_value(state),
+        )
+
+
+def estimate_jobs(selected):
+    selected = selected or []
+    rotations = sum(direction != "south" for direction in selected)
+    total = 1 + rotations + len(selected) * 2
+    return (
+        f"전체 실행 예상: {total}개 작업 "
+        f"(외형 1 + 방향 {rotations} + 걷기 {len(selected) * 2}) · "
+        "방향별 최대 4개 병렬"
+    )
+
+
+def new_seed():
+    return secrets.randbelow(2_147_483_647) + 1
+
+
+def ui_run_all(
+    source,
+    appearance,
+    selected,
+    server,
+    api_key,
+    seed,
+    steps,
+    cfg,
+    strength,
+    state,
+    progress=gr.Progress(),
+):
+    try:
+        if not selected:
+            raise ValueError("생성할 방향을 하나 이상 선택해 주세요.")
+        total = 1 + sum(direction != "south" for direction in selected) + len(selected) * 2
+        progress((0, total), desc="Standing 외형 생성")
+        state, active, palette, _ = dress_core(
+            source,
+            appearance,
+            server,
+            api_key,
+            seed,
+            steps,
+            cfg,
+            strength,
+            state,
+        )
+        yield (
+            active,
+            palette,
+            *direction_values(state),
+            walk_value(state),
+            None,
+            None,
+            active,
+            "Standing 완료 · 방향 작업을 병렬로 시작합니다.",
+            state,
+            history_value(state),
+        )
+        for state, message in direction_results(
+            selected,
+            active,
+            server,
+            api_key,
+            int(seed) + 100,
+            steps,
+            cfg,
+            strength,
+            state,
+            progress,
+        ):
+            yield (
+                active,
+                state.get("active_palette") or palette,
+                *direction_values(state),
+                walk_value(state),
+                None,
+                None,
+                active,
+                message,
+                state,
+                history_value(state),
+            )
+        for state, message in walk_results(
+            selected,
+            server,
+            api_key,
+            int(seed) + 200,
+            steps,
+            cfg,
+            strength,
+            state,
+            progress,
+        ):
+            available = [
+                state["walks"][direction]
+                for direction in selected
+                if direction in state["walks"]
+            ]
+            latest = available[-1] if available else None
+            yield (
+                active,
+                state.get("active_palette") or palette,
+                *direction_values(state),
+                walk_value(state),
+                latest,
+                animation_preview(latest) if latest else None,
+                latest,
+                f"{message} · 전체 {total}개 작업 · 시드 {int(seed)}",
+                state,
+                history_value(state),
+            )
+    except Exception as error:
+        yield (
+            (state or {}).get("active_standing") or None,
+            None,
+            *direction_values(state),
+            walk_value(state),
+            None,
+            None,
+            None,
+            format_failure(error),
+            state,
+            history_value(state),
+        )
+
+
+def use_active(state):
+    path = (state or {}).get("active_standing")
+    if not path:
+        return None, "먼저 Standing 캐릭터를 완성해 주세요."
+    return path, "활성 캐릭터를 입력으로 가져왔습니다."
+
+
+def walk_base(direction):
+    return str(BASE_WALKS[direction])
+
+
+def ui_single_walk(
+    direction,
+    source,
+    server,
+    api_key,
+    seed,
+    steps,
+    cfg,
+    strength,
+    state,
+    progress=gr.Progress(),
+):
+    state = state_copy(state)
+    if source:
+        state["directions"][direction] = source
+        if direction == "south" and not state.get("active_standing"):
+            state["active_standing"] = source
+    yield from ui_walks(
+        [direction],
+        server,
+        api_key,
+        seed,
+        steps,
+        cfg,
+        strength,
+        state,
+        progress,
+    )
+
+
+def local_process(
+    source,
+    palette_source,
+    palette_mode,
+    align,
+    resolution,
+    output_format,
+    fps,
+    set_active,
+    state,
+):
+    try:
+        if not source:
+            raise ValueError("처리할 이미지를 선택해 주세요.")
+        with Image.open(source) as image:
+            sheet = image.width >= image.height * 1.5
+        task = "Dress 4x2 walk sheet" if sheet else "Dress standing character"
+        final = process_output(
+            source,
+            source,
+            task,
+            palette_source,
+            palette_mode,
+            align and sheet,
+            True,
+            resolution,
+            output_format,
+            fps,
+        )
+        final = persist(final, "pixel_palette")
+        palette = palette_preview(palette_source or final, "palette")
+        state = state_copy(state)
+        state["active_palette"] = palette
+        if set_active and not sheet and output_format == "PNG sheet":
+            state["active_standing"] = final
+            state["directions"]["south"] = final
+        add_history(state, final, "픽셀·팔레트 처리")
+        return (
+            final,
+            final,
+            palette,
+            palette,
+            "완료 · Perfect Pixel 격자와 32색 팔레트를 적용했습니다.",
+            state,
+            history_value(state),
+            state.get("active_standing") or None,
+        )
+    except Exception as error:
+        return (
+            None,
+            None,
+            None,
+            None,
+            format_failure(error),
+            state,
+            history_value(state),
+            (state or {}).get("active_standing") or None,
+        )
+
+
+def check_connection(server_value, api_key_value):
+    try:
+        server = normalize_server(server_value)
+        api_key = resolve_api_key(api_key_value)
+        if is_cloud(server) and not api_key:
+            raise ValueError("Comfy Cloud API 키가 설정되지 않았습니다.")
+        response = requests.get(
+            f"{server}/api/prompt",
+            headers=headers(api_key),
+            timeout=15,
+        )
+        response.raise_for_status()
+        return (
+            f"연결 확인 · {urlsplit(server).hostname} 응답 "
+            f"(HTTP {response.status_code})"
+        )
+    except Exception as error:
+        return format_failure(error)
+
+
+def prompt_preview(task, direction, appearance):
+    try:
+        return make_prompt(task, direction, appearance)
+    except Exception as error:
+        return str(error)
+
+
+def ui_advanced(
+    source,
+    task,
+    direction,
+    appearance,
+    server,
+    api_key,
+    seed,
+    steps,
+    cfg,
+    strength,
+    palette_source,
+    palette_mode,
+    align,
+    resolution,
+    output_format,
+    fps,
+    state,
+):
+    try:
+        final, job_id = generate(
+            server,
+            api_key,
+            source,
+            task,
+            direction,
+            appearance,
+            seed,
+            steps,
+            cfg,
+            strength,
+            palette_source,
+            palette_mode,
+            align,
+            True,
+            resolution,
+            output_format,
+            fps,
+            prefix="advanced",
+        )
+        state = state_copy(state)
+        add_history(state, final, f"고급 단일 작업 · {TASK_LABELS[task]}")
+        return (
+            final,
+            final,
+            f"완료 · {TASK_LABELS[task]} · {job_id}",
+            state,
+            history_value(state),
+        )
+    except Exception as error:
+        return None, None, format_failure(error), state, history_value(state)
+
+
+def render_stage_strip(state):
+    state = state or initial_state()
+    direction_count = len(state.get("directions", {}))
+    walk_count = len(state.get("walks", {}))
+    if not state.get("active_standing"):
+        current = 0
+    elif direction_count < 4:
+        current = 2
+    elif walk_count < 4:
+        current = 3
+    else:
+        current = 4
+    stages = [
+        ("베이스", "실제 LPC 원본 선택"),
+        ("외형", "머리·복장·장식"),
+        ("방향", f"{direction_count}/4 완료"),
+        ("걷기", f"{walk_count}/4 완료"),
+        ("내보내기", "PNG·GIF"),
+    ]
+    items = "".join(
+        f'<div class="stage {"complete" if index < current else "current" if index == current else ""}">'
+        f"<b>{title}</b><span>{detail}</span></div>"
+        for index, (title, detail) in enumerate(stages)
+    )
+    return f'<div class="stage-strip" aria-label="LPC 제작 단계">{items}</div>'
+
+
+def project_rail(state):
+    state = state or initial_state()
+    return (
+        render_stage_strip(state),
+        state.get("active_palette") or None,
+        "현재 프로젝트 · "
+        f"Standing {'완료' if state.get('active_standing') else '대기'} · "
+        f"방향 {len(state.get('directions', {}))}/4 · "
+        f"걷기 {len(state.get('walks', {}))}/4",
+    )
+
+CSS = """
+:root {
+  --paper: #f4f3ed;
+  --proof: #ffffff;
+  --ink: #171918;
+  --muted: #5d625f;
+  --line: #c9cbc5;
+  --steel: #e2e3de;
+  --blue: #2458d6;
+  --blue-deep: #173b94;
+  --red: #d13f2d;
+  --red-deep: #b62f21;
+  --success: #18723a;
+}
+body, .gradio-container {
+  background: var(--paper) !important;
+  color: var(--ink) !important;
+  font-family: "Segoe UI", "Noto Sans KR", Arial, sans-serif !important;
+}
+.gradio-container { max-width: 1760px !important; margin: 0 auto !important; }
+#app-shell { border: 1px solid var(--ink); background: var(--proof); }
+.app-header {
+  display: grid;
+  grid-template-columns: minmax(260px, 1fr) auto;
+  align-items: end;
+  gap: 24px;
+  padding: 22px 26px 18px;
+  border-bottom: 4px solid var(--ink);
+  background: var(--proof);
+}
+.app-header h1 { margin: 0; font-size: clamp(1.6rem, 3vw, 2.7rem); line-height: 1; letter-spacing: -0.03em; }
+.app-header p { max-width: 70ch; margin: 8px 0 0; color: var(--muted); }
+.connection-note { color: var(--success); font-weight: 700; white-space: nowrap; }
+.stage-strip {
+  display: grid;
+  grid-template-columns: repeat(5, 1fr);
+  border: 1px solid var(--ink);
+  background: var(--ink);
+  gap: 1px;
+}
+.stage { min-height: 68px; padding: 12px 14px; background: var(--proof); }
+.stage b, .stage span { display: block; }
+.stage b { font-size: 1rem; }
+.stage span { margin-top: 4px; color: var(--muted); font-size: .82rem; }
+.stage.current { background: var(--blue); color: white; }
+.stage.current span { color: #eef3ff; }
+.stage.complete { box-shadow: inset 0 -5px 0 var(--success); }
+.proof, .tool-rail, .contact-sheet, .settings-panel {
+  background: var(--proof) !important;
+  border: 1px solid var(--ink) !important;
+  border-radius: 2px !important;
+}
+.proof { position: relative; padding: 12px !important; }
+.proof::before, .proof::after {
+  content: "";
+  position: absolute;
+  width: 18px;
+  height: 18px;
+  border: 2px solid var(--blue);
+  border-radius: 50%;
+  pointer-events: none;
+}
+.proof::before { top: 10px; left: 10px; }
+.proof::after { right: 10px; bottom: 10px; }
+.pixel-preview img, .pixel-gallery img, .proof img { image-rendering: pixelated !important; }
+.tool-rail { padding: 14px !important; }
+.registration-label {
+  font-family: Consolas, "Courier New", monospace;
+  color: var(--blue-deep);
+  font-size: .78rem;
+  letter-spacing: .02em;
+}
+.status-line textarea, .status-line input {
+  font-weight: 700 !important;
+  color: var(--ink) !important;
+  background: var(--steel) !important;
+}
+button.primary {
+  background: var(--red) !important;
+  border: 1px solid var(--red-deep) !important;
+  color: white !important;
+  border-radius: 2px !important;
+  font-weight: 800 !important;
+}
+button.primary:hover { background: var(--red-deep) !important; }
+button.secondary { border-radius: 2px !important; border-color: var(--ink) !important; }
+button:focus-visible, input:focus-visible, textarea:focus-visible, [role="tab"]:focus-visible {
+  outline: 3px solid var(--blue) !important;
+  outline-offset: 2px !important;
+}
+[role="tablist"] { gap: 0 !important; border-bottom: 1px solid var(--ink); }
+[role="tab"] { border-radius: 0 !important; font-weight: 750 !important; min-height: 48px; }
+[role="tab"][aria-selected="true"] { background: var(--blue) !important; color: white !important; }
+.direction-board { background: var(--proof); border: 1px solid var(--ink); padding: 10px !important; }
+.direction-board .gr-image { border-color: var(--blue) !important; }
+.palette-strip img { image-rendering: pixelated !important; min-height: 68px; object-fit: contain; }
+.proof-log { border-top: 4px solid var(--ink) !important; }
+.advanced-panel { border-top: 1px dashed var(--muted) !important; }
+footer { display: none !important; }
+@media (max-width: 900px) {
+  .app-header { grid-template-columns: 1fr; }
+  .connection-note { white-space: normal; }
+  .stage-strip { grid-template-columns: 1fr; }
+  .stage { min-height: 50px; }
+}
+@media (prefers-reduced-motion: reduce) {
+  *, *::before, *::after { scroll-behavior: auto !important; transition-duration: .01ms !important; animation-duration: .01ms !important; }
+}
+"""
+
+
+def build_ui():
+    env_note = (
+        "로컬 환경 설정 감지"
+        if ENV_PATH and resolve_api_key("")
+        else "설정 탭에서 Comfy 연결 필요"
+    )
+    default_server = os.getenv("COMFY_URL", "https://cloud.comfy.org")
+    base_gallery_value = [(str(BASE_STANDING), "여성 기본 Standing · 남쪽")]
+
+    with gr.Blocks(
+        title="LPC 사방향 제작 작업대",
+        fill_width=True,
+        delete_cache=(86400, 86400),
+    ) as demo:
+        project_state = gr.State(initial_state())
+
+        gr.HTML(
+            f"""
+            <header class="app-header" id="app-shell">
+              <div>
+                <div class="registration-label">LPC / FOUR-DIRECTION / PROOF WORKBENCH</div>
+                <h1>LPC 사방향 제작 작업대</h1>
+                <p>베이스 캐릭터에서 외형, 방향, 8프레임 걷기, 32색 내보내기까지 한 흐름으로 만듭니다.</p>
+              </div>
+              <div class="connection-note">{env_note}</div>
+            </header>
+            """
+        )
+
+        with gr.Row(elem_classes="settings-panel"):
+            gr.Markdown(
+                "**공통 LoRA 강도** · 모든 생성 작업에 적용됩니다. "
+                "`0`은 LoRA 비활성화, `1.0`은 기본 강도입니다."
+            )
+            strength = gr.Slider(
+                0,
+                1.5,
+                value=1,
+                step=0.05,
+                label="LoRA 강도",
+                scale=2,
+            )
+
+        with gr.Tabs():
+            with gr.Tab("빠른 제작", id="quick"):
+                quick_stage_strip = gr.HTML(render_stage_strip(initial_state()))
+                with gr.Row(equal_height=True):
+                    with gr.Column(scale=3, elem_classes="tool-rail"):
+                        gr.Markdown("### 실제 LPC 베이스")
+                        quick_base_gallery = gr.Gallery(
+                            base_gallery_value,
+                            columns=1,
+                            rows=1,
+                            height=250,
+                            label="내장 베이스",
+                            show_label=False,
+                            elem_classes="pixel-gallery",
+                        )
+                        quick_source = gr.Image(
+                            value=str(BASE_STANDING),
+                            type="filepath",
+                            label="선택된 베이스",
+                            elem_classes="pixel-preview",
+                        )
+                        gr.Markdown(
+                            "학습에 사용한 여성 기본 체형과 헤드입니다. "
+                            "다른 체형은 현재 모델의 보장 범위가 아닙니다."
+                        )
+                    with gr.Column(scale=5, elem_classes="proof"):
+                        gr.Markdown("### 활성 캐릭터 교정쇄")
+                        active_proof = gr.Image(
+                            type="filepath",
+                            label="현재 Standing 캐릭터",
+                            height=560,
+                            elem_classes="pixel-preview",
+                        )
+                        quick_palette = gr.Image(
+                            type="filepath",
+                            label="활성 32색 팔레트",
+                            height=90,
+                            elem_classes="palette-strip",
+                        )
+                    with gr.Column(scale=4, elem_classes="tool-rail"):
+                        gr.Markdown("### 다음 작업 · 외형 만들기")
+                        quick_appearance = gr.Textbox(
+                            label="원하는 외형",
+                            lines=5,
+                            placeholder=(
+                                "예: 파란 단발머리, 붉은 긴팔 상의, "
+                                "남색 바지, 갈색 부츠, 금색 안경"
+                            ),
+                        )
+                        quick_directions = gr.CheckboxGroup(
+                            choices=[
+                                (DIRECTION_LABELS[direction], direction)
+                                for direction in DIRECTIONS
+                            ],
+                            value=list(DIRECTIONS),
+                            label="만들 방향",
+                        )
+                        quick_estimate = gr.Textbox(
+                            value=estimate_jobs(list(DIRECTIONS)),
+                            label="전체 실행 작업 수",
+                            interactive=False,
+                        )
+                        quick_dress_button = gr.Button(
+                            "1단계 · Standing 외형 만들기",
+                            variant="primary",
+                            elem_classes="primary",
+                        )
+                        quick_dress_reroll = gr.Button(
+                            "새 시드로 1단계 다시 만들기",
+                            elem_classes="secondary",
+                        )
+                        quick_direction_button = gr.Button(
+                            "2단계 · 선택 방향 만들기",
+                            elem_classes="secondary",
+                        )
+                        quick_direction_reroll = gr.Button(
+                            "새 시드로 2단계 다시 만들기",
+                            elem_classes="secondary",
+                        )
+                        quick_walk_button = gr.Button(
+                            "3단계 · 걷기 만들기",
+                            elem_classes="secondary",
+                        )
+                        quick_walk_reroll = gr.Button(
+                            "새 시드로 3단계 다시 만들기",
+                            elem_classes="secondary",
+                        )
+                        with gr.Accordion("전체 자동 실행", open=False):
+                            gr.Markdown(
+                                "단계 순서는 유지하고, 같은 단계의 방향 작업은 "
+                                "최대 4개까지 병렬 실행합니다."
+                            )
+                            quick_all_button = gr.Button(
+                                "전체 실행",
+                                variant="stop",
+                                elem_classes="primary",
+                            )
+                        quick_file = gr.File(label="최근 결과 다운로드")
+                gr.Markdown("### 방향 교정쇄")
+                with gr.Column(elem_classes="direction-board"):
+                    with gr.Row():
+                        quick_north = gr.Image(
+                            label="북쪽", type="filepath", elem_classes="pixel-preview"
+                        )
+                    with gr.Row():
+                        quick_west = gr.Image(
+                            label="서쪽", type="filepath", elem_classes="pixel-preview"
+                        )
+                        quick_south = gr.Image(
+                            label="남쪽", type="filepath", elem_classes="pixel-preview"
+                        )
+                        quick_east = gr.Image(
+                            label="동쪽", type="filepath", elem_classes="pixel-preview"
+                        )
+                quick_walks = gr.Gallery(
+                    label="방향별 4×2 걷기 시트",
+                    columns=2,
+                    type="filepath",
+                    elem_classes="pixel-gallery contact-sheet",
+                )
+                quick_animation = gr.Image(
+                    type="filepath",
+                    label="최근 완성 시트 애니메이션",
+                    height=300,
+                    elem_classes="pixel-preview",
+                )
+                quick_status = gr.Textbox(
+                    value="준비 · 실제 LPC 베이스를 선택하고 외형을 설명해 주세요.",
+                    label="작업 상태",
+                    interactive=False,
+                    elem_classes="status-line",
+                )
+
+            with gr.Tab("Standing 외형", id="standing"):
+                with gr.Row(equal_height=True):
+                    with gr.Column(scale=4, elem_classes="tool-rail"):
+                        gr.Markdown("### 원본 교정쇄")
+                        standing_source = gr.Image(
+                            value=str(BASE_STANDING),
+                            type="filepath",
+                            label="Standing 입력",
+                            sources=["upload", "clipboard"],
+                            elem_classes="pixel-preview",
+                        )
+                    with gr.Column(scale=4, elem_classes="tool-rail"):
+                        gr.Markdown("### 외형 지시")
+                        standing_appearance = gr.Textbox(
+                            label="머리·상의·하의·신발·장식",
+                            lines=8,
+                            placeholder=(
+                                "예: 짙은 보라색 웨이브 머리, 흰 블라우스, "
+                                "검은 치마, 검은 부츠, 은색 머리핀"
+                            ),
+                        )
+                        standing_button = gr.Button(
+                            "Standing 외형 생성",
+                            variant="primary",
+                            elem_classes="primary",
+                        )
+                        standing_reroll = gr.Button(
+                            "새 시드로 다시 생성",
+                            elem_classes="secondary",
+                        )
+                        standing_status = gr.Textbox(
+                            label="상태",
+                            interactive=False,
+                            elem_classes="status-line",
+                        )
+                    with gr.Column(scale=5, elem_classes="proof"):
+                        gr.Markdown("### 완성 교정쇄")
+                        standing_output = gr.Image(
+                            type="filepath",
+                            label="완성 Standing",
+                            height=520,
+                            elem_classes="pixel-preview",
+                        )
+                        standing_palette = gr.Image(
+                            type="filepath",
+                            label="생성된 32색 팔레트",
+                            height=90,
+                            elem_classes="palette-strip",
+                        )
+                        standing_file = gr.File(label="Standing 다운로드")
+
+            with gr.Tab("방향 만들기", id="directions"):
+                with gr.Row():
+                    with gr.Column(scale=3, elem_classes="tool-rail"):
+                        direction_source = gr.Image(
+                            type="filepath",
+                            label="기준 Standing",
+                            sources=["upload", "clipboard"],
+                            elem_classes="pixel-preview",
+                        )
+                        use_active_direction = gr.Button(
+                            "활성 캐릭터 가져오기",
+                            elem_classes="secondary",
+                        )
+                        direction_choices = gr.CheckboxGroup(
+                            choices=[
+                                (DIRECTION_LABELS[direction], direction)
+                                for direction in DIRECTIONS
+                            ],
+                            value=list(DIRECTIONS),
+                            label="생성 방향",
+                        )
+                        direction_button = gr.Button(
+                            "선택 방향 단계별 생성",
+                            variant="primary",
+                            elem_classes="primary",
+                        )
+                        direction_reroll = gr.Button(
+                            "새 시드로 선택 방향 다시 생성",
+                            elem_classes="secondary",
+                        )
+                        direction_status = gr.Textbox(
+                            label="상태",
+                            interactive=False,
+                            elem_classes="status-line",
+                        )
+                    with gr.Column(scale=9, elem_classes="direction-board"):
+                        gr.Markdown("### 사방향 턴어라운드 교정판")
+                        with gr.Row():
+                            direction_north = gr.Image(
+                                label="북쪽",
+                                type="filepath",
+                                elem_classes="pixel-preview",
+                            )
+                        with gr.Row():
+                            direction_west = gr.Image(
+                                label="서쪽",
+                                type="filepath",
+                                elem_classes="pixel-preview",
+                            )
+                            direction_south = gr.Image(
+                                label="남쪽",
+                                type="filepath",
+                                elem_classes="pixel-preview",
+                                scale=2,
+                            )
+                            direction_east = gr.Image(
+                                label="동쪽",
+                                type="filepath",
+                                elem_classes="pixel-preview",
+                            )
+
+            with gr.Tab("걷기 만들기", id="walk"):
+                with gr.Row(equal_height=True):
+                    with gr.Column(scale=3, elem_classes="tool-rail"):
+                        walk_direction = gr.Dropdown(
+                            choices=[
+                                (DIRECTION_LABELS[direction], direction)
+                                for direction in DIRECTIONS
+                            ],
+                            value="south",
+                            label="방향",
+                        )
+                        walk_source = gr.Image(
+                            type="filepath",
+                            label="해당 방향 Standing",
+                            sources=["upload", "clipboard"],
+                            elem_classes="pixel-preview",
+                        )
+                        use_active_walk = gr.Button(
+                            "활성 남쪽 캐릭터 가져오기",
+                            elem_classes="secondary",
+                        )
+                        walk_button = gr.Button(
+                            "첫 프레임 → 8프레임 생성",
+                            variant="primary",
+                            elem_classes="primary",
+                        )
+                        walk_reroll = gr.Button(
+                            "새 시드로 다시 생성",
+                            elem_classes="secondary",
+                        )
+                        walk_status = gr.Textbox(
+                            label="상태",
+                            interactive=False,
+                            elem_classes="status-line",
+                        )
+                    with gr.Column(scale=4, elem_classes="proof"):
+                        gr.Markdown("### 내장 4×2 자세 베이스")
+                        walk_base_preview = gr.Image(
+                            value=str(BASE_WALKS["south"]),
+                            type="filepath",
+                            label="방향별 베이스",
+                            elem_classes="pixel-preview",
+                        )
+                    with gr.Column(scale=5, elem_classes="proof"):
+                        gr.Markdown("### 완성 4×2 걷기 교정쇄")
+                        walk_output = gr.Image(
+                            type="filepath",
+                            label="완성 걷기 시트",
+                            elem_classes="pixel-preview",
+                        )
+                        walk_animation = gr.Image(
+                            type="filepath",
+                            label="현재 시트 애니메이션",
+                            height=300,
+                            elem_classes="pixel-preview",
+                        )
+                        walk_file = gr.File(label="걷기 시트 다운로드")
+                walk_gallery = gr.Gallery(
+                    label="현재 프로젝트의 방향별 걷기",
+                    columns=2,
+                    type="filepath",
+                    elem_classes="pixel-gallery contact-sheet",
+                )
+
+            with gr.Tab("픽셀·팔레트", id="pixel"):
+                with gr.Row(equal_height=True):
+                    with gr.Column(scale=4, elem_classes="tool-rail"):
+                        pixel_source = gr.Image(
+                            type="filepath",
+                            label="처리할 Standing 또는 4×2 시트",
+                            sources=["upload", "clipboard"],
+                            elem_classes="pixel-preview",
+                        )
+                        use_active_pixel = gr.Button(
+                            "활성 캐릭터 가져오기",
+                            elem_classes="secondary",
+                        )
+                        palette_source = gr.Image(
+                            type="filepath",
+                            label="고정할 팔레트 기준 이미지",
+                            sources=["upload", "clipboard"],
+                            elem_classes="pixel-preview",
+                        )
+                        palette_mode = gr.Radio(
+                            PALETTE_CHOICES,
+                            value="Allow new colors (32)",
+                            label="팔레트 방식",
+                        )
+                    with gr.Column(scale=3, elem_classes="tool-rail"):
+                        pixel_align = gr.Checkbox(
+                            value=True,
+                            label="4×2 프레임 발 위치 정렬",
+                        )
+                        pixel_resolution = gr.Radio(
+                            RESOLUTION_CHOICES,
+                            value="Native LPC",
+                            label="해상도",
+                        )
+                        pixel_format = gr.Radio(
+                            FORMAT_CHOICES,
+                            value="PNG sheet",
+                            label="출력 형식",
+                        )
+                        pixel_fps = gr.Slider(
+                            1, 20, value=8, step=1, label="GIF FPS"
+                        )
+                        set_active = gr.Checkbox(
+                            value=True,
+                            label="Standing 결과를 활성 캐릭터로 지정",
+                        )
+                        pixel_button = gr.Button(
+                            "Perfect Pixel 격자·32색 적용",
+                            variant="primary",
+                            elem_classes="primary",
+                        )
+                        pixel_status = gr.Textbox(
+                            label="상태",
+                            interactive=False,
+                            elem_classes="status-line",
+                        )
+                    with gr.Column(scale=5, elem_classes="proof"):
+                        pixel_output = gr.Image(
+                            type="filepath",
+                            label="처리 결과",
+                            elem_classes="pixel-preview",
+                        )
+                        pixel_palette = gr.Image(
+                            type="filepath",
+                            label="32색 팔레트",
+                            height=90,
+                            elem_classes="palette-strip",
+                        )
+                        with gr.Row():
+                            pixel_file = gr.File(label="이미지 다운로드")
+                            palette_file = gr.File(label="팔레트 PNG")
+
+            with gr.Tab("결과·설정", id="settings"):
+                with gr.Row():
+                    with gr.Column(scale=7, elem_classes="proof-log"):
+                        gr.Markdown("### 최근 결과")
+                        history_gallery = gr.Gallery(
+                            label="이 세션에서 생성한 파일",
+                            columns=4,
+                            type="filepath",
+                            elem_classes="pixel-gallery",
+                        )
+                    with gr.Column(scale=5, elem_classes="settings-panel"):
+                        gr.Markdown("### Comfy 연결")
+                        server = gr.Textbox(
+                            value=default_server,
+                            label="ComfyUI 서버",
+                            placeholder="https://cloud.comfy.org",
+                        )
+                        api_key = gr.Textbox(
+                            type="password",
+                            label="Comfy Cloud API 키",
+                            placeholder=(
+                                "비워두면 .env의 COMFY_API_KEY를 사용합니다."
+                            ),
+                        )
+                        connection_button = gr.Button(
+                            "연결 확인",
+                            elem_classes="secondary",
+                        )
+                        connection_status = gr.Textbox(
+                            value=(
+                                "환경 설정 준비됨"
+                                if ENV_PATH
+                                else "로컬 .env를 찾지 못했습니다."
+                            ),
+                            label="연결 상태",
+                            interactive=False,
+                            elem_classes="status-line",
+                        )
+                        with gr.Accordion("생성 품질 설정", open=False):
+                            seed = gr.Number(
+                                value=710001, precision=0, label="Seed"
+                            )
+                            steps = gr.Slider(
+                                12, 40, value=28, step=1, label="Steps"
+                            )
+                            cfg = gr.Slider(
+                                1, 8, value=5, step=0.1, label="CFG"
+                            )
+
+                with gr.Accordion(
+                    "고급 단일 작업 · 영어 Task 프롬프트",
+                    open=False,
+                    elem_classes="advanced-panel",
+                ):
+                    with gr.Row():
+                        advanced_source = gr.Image(
+                            type="filepath",
+                            label="입력 이미지",
+                            sources=["upload", "clipboard"],
+                            elem_classes="pixel-preview",
+                        )
+                        advanced_output = gr.Image(
+                            type="filepath",
+                            label="결과",
+                            elem_classes="pixel-preview",
+                        )
+                    with gr.Row():
+                        advanced_task = gr.Dropdown(
+                            choices=[
+                                (label, task) for task, label in TASK_LABELS.items()
+                            ],
+                            value="Rotate standing character",
+                            label="작업",
+                        )
+                        advanced_direction = gr.Dropdown(
+                            choices=[
+                                (DIRECTION_LABELS[direction], direction)
+                                for direction in DIRECTIONS
+                            ],
+                            value="north",
+                            label="방향",
+                        )
+                    advanced_appearance = gr.Textbox(
+                        label="외형 설명",
+                        lines=3,
+                    )
+                    preview_button = gr.Button(
+                        "영어 프롬프트 확인",
+                        elem_classes="secondary",
+                    )
+                    advanced_prompt = gr.Textbox(
+                        label="실제 영어 Task 프롬프트",
+                        lines=6,
+                        interactive=False,
+                    )
+                    with gr.Row():
+                        advanced_palette_source = gr.Image(
+                            type="filepath",
+                            label="팔레트 기준",
+                            elem_classes="pixel-preview",
+                        )
+                        advanced_palette_mode = gr.Radio(
+                            PALETTE_CHOICES,
+                            value="Lock reference palette",
+                            label="팔레트",
+                        )
+                    with gr.Row():
+                        advanced_align = gr.Checkbox(
+                            value=True,
+                            label="4×2 발 위치 정렬",
+                        )
+                        advanced_resolution = gr.Radio(
+                            RESOLUTION_CHOICES,
+                            value="Upscaled",
+                            label="해상도",
+                        )
+                        advanced_format = gr.Radio(
+                            FORMAT_CHOICES,
+                            value="PNG sheet",
+                            label="출력",
+                        )
+                        advanced_fps = gr.Slider(
+                            1, 20, value=8, step=1, label="GIF FPS"
+                        )
+                    advanced_button = gr.Button(
+                        "고급 단일 작업 실행",
+                        variant="primary",
+                        elem_classes="primary",
+                    )
+                    advanced_file = gr.File(label="결과 다운로드")
+                    advanced_status = gr.Textbox(
+                        label="상태",
+                        interactive=False,
+                        elem_classes="status-line",
+                    )
+
+        with gr.Row(elem_classes="proof-log"):
+            project_palette_bar = gr.Image(
+                type="filepath",
+                label="프로젝트 32색 팔레트",
+                height=90,
+                elem_classes="palette-strip",
+                scale=3,
+            )
+            project_summary = gr.Textbox(
+                value="현재 프로젝트 · Standing 대기 · 방향 0/4 · 걷기 0/4",
+                label="프로젝트 상태",
+                interactive=False,
+                elem_classes="status-line",
+                scale=2,
+            )
+
+        quick_base_gallery.select(
+            lambda: (
+                str(BASE_STANDING),
+                str(BASE_STANDING),
+                str(BASE_STANDING),
+            ),
+            outputs=[quick_source, standing_source, pixel_source],
+        )
+        quick_directions.change(
+            estimate_jobs,
+            inputs=quick_directions,
+            outputs=quick_estimate,
+        )
+
+        common_generation = [server, api_key, seed, steps, cfg, strength]
+
+        def bind_generation(button, reroll, fn, inputs, outputs):
+            normal = button.click(fn, inputs=inputs, outputs=outputs)
+            repeated = reroll.click(new_seed, outputs=seed).then(
+                fn,
+                inputs=inputs,
+                outputs=outputs,
+            )
+            return normal, repeated
+
+        def forward_active(state):
+            active = state.get("active_standing") or None
+            return active, active, active
+
+        bind_generation(
+            quick_dress_button,
+            quick_dress_reroll,
+            ui_dress,
+            [
+                quick_source,
+                quick_appearance,
+                *common_generation,
+                project_state,
+            ],
+            [
+                active_proof,
+                quick_palette,
+                quick_file,
+                quick_status,
+                project_state,
+                history_gallery,
+            ],
+        )
+        bind_generation(
+            quick_direction_button,
+            quick_direction_reroll,
+            ui_directions,
+            [
+                quick_directions,
+                active_proof,
+                *common_generation,
+                project_state,
+            ],
+            [
+                quick_north,
+                quick_west,
+                quick_south,
+                quick_east,
+                quick_status,
+                project_state,
+                history_gallery,
+            ],
+        )
+        bind_generation(
+            quick_walk_button,
+            quick_walk_reroll,
+            ui_walks,
+            [
+                quick_directions,
+                *common_generation,
+                project_state,
+            ],
+            [
+                quick_walks,
+                walk_output,
+                quick_animation,
+                quick_file,
+                quick_status,
+                project_state,
+                history_gallery,
+            ],
+        )
+        quick_all_button.click(
+            ui_run_all,
+            inputs=[
+                quick_source,
+                quick_appearance,
+                quick_directions,
+                *common_generation,
+                project_state,
+            ],
+            outputs=[
+                active_proof,
+                quick_palette,
+                quick_north,
+                quick_west,
+                quick_south,
+                quick_east,
+                quick_walks,
+                walk_output,
+                quick_animation,
+                quick_file,
+                quick_status,
+                project_state,
+                history_gallery,
+            ],
+        )
+
+        standing_events = bind_generation(
+            standing_button,
+            standing_reroll,
+            ui_dress,
+            [
+                standing_source,
+                standing_appearance,
+                *common_generation,
+                project_state,
+            ],
+            [
+                standing_output,
+                standing_palette,
+                standing_file,
+                standing_status,
+                project_state,
+                history_gallery,
+            ],
+        )
+        for event in standing_events:
+            event.then(
+                forward_active,
+                inputs=project_state,
+                outputs=[active_proof, direction_source, pixel_source],
+            )
+
+        use_active_direction.click(
+            use_active,
+            inputs=project_state,
+            outputs=[direction_source, direction_status],
+        )
+        bind_generation(
+            direction_button,
+            direction_reroll,
+            ui_directions,
+            [
+                direction_choices,
+                direction_source,
+                *common_generation,
+                project_state,
+            ],
+            [
+                direction_north,
+                direction_west,
+                direction_south,
+                direction_east,
+                direction_status,
+                project_state,
+                history_gallery,
+            ],
+        )
+
+        use_active_walk.click(
+            use_active,
+            inputs=project_state,
+            outputs=[walk_source, walk_status],
+        )
+        walk_direction.change(
+            walk_base,
+            inputs=walk_direction,
+            outputs=walk_base_preview,
+        )
+        bind_generation(
+            walk_button,
+            walk_reroll,
+            ui_single_walk,
+            [
+                walk_direction,
+                walk_source,
+                *common_generation,
+                project_state,
+            ],
+            [
+                walk_gallery,
+                walk_output,
+                walk_animation,
+                walk_file,
+                walk_status,
+                project_state,
+                history_gallery,
+            ],
+        )
+
+        use_active_pixel.click(
+            use_active,
+            inputs=project_state,
+            outputs=[pixel_source, pixel_status],
+        )
+        pixel_button.click(
+            local_process,
+            inputs=[
+                pixel_source,
+                palette_source,
+                palette_mode,
+                pixel_align,
+                pixel_resolution,
+                pixel_format,
+                pixel_fps,
+                set_active,
+                project_state,
+            ],
+            outputs=[
+                pixel_output,
+                pixel_file,
+                pixel_palette,
+                palette_file,
+                pixel_status,
+                project_state,
+                history_gallery,
+                active_proof,
+            ],
+        )
+
+        connection_button.click(
+            check_connection,
+            inputs=[server, api_key],
+            outputs=connection_status,
+        )
+        preview_button.click(
+            prompt_preview,
+            inputs=[
+                advanced_task,
+                advanced_direction,
+                advanced_appearance,
+            ],
+            outputs=advanced_prompt,
+        )
+        advanced_button.click(
+            ui_advanced,
+            inputs=[
+                advanced_source,
+                advanced_task,
+                advanced_direction,
+                advanced_appearance,
+                *common_generation,
+                advanced_palette_source,
+                advanced_palette_mode,
+                advanced_align,
+                advanced_resolution,
+                advanced_format,
+                advanced_fps,
+                project_state,
+            ],
+            outputs=[
+                advanced_output,
+                advanced_file,
+                advanced_status,
+                project_state,
+                history_gallery,
+            ],
+        )
+        project_state.change(
+            project_rail,
+            inputs=project_state,
+            outputs=[quick_stage_strip, project_palette_bar, project_summary],
+        )
+
+    return demo
+
+
+def self_check():
+    assert normalize_server("https://cloud.comfy.org/#project") == (
+        "https://cloud.comfy.org"
+    )
+    try:
+        normalize_server("https://cloud.comfy.orghttps://cloud.comfy.org")
+    except ValueError:
+        pass
+    else:
+        raise AssertionError("Repeated server URLs must be rejected.")
+    assert make_prompt("Rotate standing character", "west", "").startswith(
+        "TASK_ROTATE_STANDING:"
+    )
+    assert "4 by 2" in make_prompt(
+        "Dress 4x2 walk sheet", "east", "blue hair and black clothes"
+    )
+    assert estimate_jobs(list(DIRECTIONS)).startswith("전체 실행 예상: 12개")
+    assert MAX_PARALLEL_REQUESTS == 4
+    assert 1 <= new_seed() <= 2_147_483_647
+    assert 'class="stage current"' in render_stage_strip(initial_state())
+    assert BASE_STANDING.exists() and all(path.exists() for path in BASE_WALKS.values())
+    workflow = json.loads(WORKFLOW.read_text(encoding="utf-8"))
+    assert workflow["4"]["class_type"] == "LoraLoaderModelOnly"
+    assert workflow["4"]["inputs"]["model"] == ["3", 0]
+
+    first = Image.new("RGB", (64, 64), "red")
+    with tempfile.NamedTemporaryFile(delete=False, suffix=".png") as handle:
+        first.save(handle.name)
+        composed = compose_first_frame(handle.name, "south")
+    with Image.open(composed) as sheet:
+        assert sheet.size == (2048, 1024)
+        assert sheet.getpixel((10, 10)) == (255, 0, 0)
+    Path(handle.name).unlink(missing_ok=True)
+    Path(composed).unlink(missing_ok=True)
+    print("self-check passed")
+
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--check", action="store_true")
+    args = parser.parse_args()
+    if args.check:
+        self_check()
+    else:
+        OUTPUT_DIR.mkdir(exist_ok=True)
+        build_ui().queue(default_concurrency_limit=1).launch(
+            css=CSS,
+            allowed_paths=[str(BASE_DIR), str(OUTPUT_DIR)],
+            ssr_mode=False,
+        )

assets/bases/README.md

@@ -0,0 +1,11 @@
+# Bundled LPC bases
+
+These five white-background images are the fixed feminine thin body and head
+used by the GUI:
+
+- one south-facing standing base;
+- north, west, south, and east 4×2 walking-pose bases.
+
+They are derived from [ElizaWy/LPC](https://github.com/ElizaWy/LPC). The
+applicable LPC contributor credits and OGA-BY 3.0 attribution are preserved in
+[`THIRD_PARTY_NOTICES.txt`](../../THIRD_PARTY_NOTICES.txt).

convert_fal_lora_to_comfy.py

@@ -0,0 +1,40 @@
+import argparse
+from pathlib import Path
+
+from safetensors import safe_open
+from safetensors.torch import save_file
+
+
+SOURCE_PREFIX = "base_model.model."
+COMFY_PREFIX = "diffusion_model."
+
+
+def convert(source, destination):
+    tensors = {}
+    with safe_open(source, framework="pt", device="cpu") as model:
+        for key in model.keys():
+            if not key.startswith(SOURCE_PREFIX):
+                raise ValueError(f"Unsupported key: {key}")
+            tensors[COMFY_PREFIX + key.removeprefix(SOURCE_PREFIX)] = model.get_tensor(key)
+
+    save_file(
+        tensors,
+        destination,
+        metadata={
+            "format": "pt",
+            "source_format": "fal-peft",
+            "target": "ComfyUI FLUX.2",
+        },
+    )
+    return len(tensors)
+
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser(
+        description="Convert a fal FLUX.2 PEFT LoRA to ComfyUI key names."
+    )
+    parser.add_argument("source", type=Path)
+    parser.add_argument("destination", type=Path)
+    args = parser.parse_args()
+    count = convert(args.source, args.destination)
+    print(f"converted {count} tensors: {args.destination}")

postprocess.py

@@ -0,0 +1,338 @@
+import tempfile
+from collections import deque
+from pathlib import Path
+
+import numpy as np
+from perfect_pixel import get_perfect_pixel
+from PIL import Image, ImageFilter
+
+
+COLUMNS = 4
+ROWS = 2
+SHEET_TASKS = {"Propagate frame 1 appearance", "Dress 4x2 walk sheet"}
+
+
+def remove_white_background(image, minimum_tolerance=48):
+    rgb = np.asarray(image.convert("RGB"), dtype=np.float32)
+    border = np.concatenate((rgb[0], rgb[-1], rgb[:, 0], rgb[:, -1]))
+    background = np.median(border, axis=0)
+    tolerance = max(
+        minimum_tolerance,
+        float(np.percentile(np.linalg.norm(border - background, axis=1), 50) + 8),
+    )
+    rough = np.linalg.norm(rgb - background, axis=2) > tolerance
+    rough = np.asarray(
+        Image.fromarray(rough.astype(np.uint8) * 255)
+        .filter(ImageFilter.MaxFilter(3))
+        .filter(ImageFilter.MinFilter(3))
+    ) > 0
+    height, width = rough.shape
+    seen = np.zeros_like(rough)
+    components = []
+    for seed_y, seed_x in zip(*np.nonzero(rough)):
+        if seen[seed_y, seed_x]:
+            continue
+        seen[seed_y, seed_x] = True
+        queue = [(int(seed_y), int(seed_x))]
+        component = []
+        while queue:
+            y, x = queue.pop()
+            component.append((y, x))
+            for next_y, next_x in ((y - 1, x), (y + 1, x), (y, x - 1), (y, x + 1)):
+                if (
+                    0 <= next_y < height
+                    and 0 <= next_x < width
+                    and rough[next_y, next_x]
+                    and not seen[next_y, next_x]
+                ):
+                    seen[next_y, next_x] = True
+                    queue.append((next_y, next_x))
+        components.append(component)
+    if not components:
+        return Image.new("RGBA", image.size)
+
+    minimum_area = max(4, round(max(map(len, components)) * 0.002))
+    solid = np.zeros_like(rough)
+    for component in components:
+        if len(component) >= minimum_area:
+            y, x = zip(*component)
+            solid[y, x] = True
+
+    outside = np.zeros_like(solid)
+    queue = deque()
+    for x in range(width):
+        queue.extend(((0, x), (height - 1, x)))
+    for y in range(height):
+        queue.extend(((y, 0), (y, width - 1)))
+    while queue:
+        y, x = queue.popleft()
+        if outside[y, x] or solid[y, x]:
+            continue
+        outside[y, x] = True
+        for next_y, next_x in ((y - 1, x), (y + 1, x), (y, x - 1), (y, x + 1)):
+            if 0 <= next_y < height and 0 <= next_x < width:
+                queue.append((next_y, next_x))
+    solid |= ~outside
+    alpha = solid.astype(np.uint8) * 255
+    return Image.fromarray(np.dstack((rgb.astype(np.uint8), alpha)), "RGBA")
+
+
+def foot_anchor(image):
+    alpha = np.asarray(image.getchannel("A"), dtype=np.float64) / 255
+    y, x = np.nonzero(alpha > 0.25)
+    if not len(x):
+        raise ValueError("A 4x2 frame contains no foreground sprite.")
+    bottom = int(y.max())
+    band = y >= bottom - max(2, round(image.height * 0.06))
+    return float(np.average(x[band], weights=alpha[y[band], x[band]])), bottom
+
+
+def align_4x2(source, reference):
+    if source.width % COLUMNS or source.height % ROWS:
+        raise ValueError("The generated sheet must be divisible into a 4x2 grid.")
+    frame_width = source.width // COLUMNS
+    frame_height = source.height // ROWS
+    reference = reference.resize(source.size, Image.Resampling.NEAREST)
+    result = Image.new("RGBA", source.size)
+
+    for index in range(COLUMNS * ROWS):
+        row, column = divmod(index, COLUMNS)
+        box = (
+            column * frame_width,
+            row * frame_height,
+            (column + 1) * frame_width,
+            (row + 1) * frame_height,
+        )
+        generated = remove_white_background(source.crop(box))
+        sprite_box = generated.getbbox()
+        if not sprite_box:
+            raise ValueError(f"Generated frame {index + 1} is empty.")
+        sprite = generated.crop(sprite_box)
+        generated_x, generated_y = foot_anchor(sprite)
+        reference_frame = remove_white_background(reference.crop(box), 4)
+        reference_x, reference_y = foot_anchor(reference_frame)
+
+        frame = Image.new("RGBA", (frame_width, frame_height))
+        frame.alpha_composite(
+            sprite,
+            (
+                round(reference_x - generated_x),
+                round(reference_y - generated_y),
+            ),
+        )
+        result.alpha_composite(frame, (box[0], box[1]))
+
+    white = Image.new("RGBA", result.size, "white")
+    white.alpha_composite(result)
+    return white.convert("RGB")
+
+
+def adaptive_palette(image, colors=32):
+    quantized = image.convert("RGB").quantize(
+        colors=colors, method=Image.Quantize.MEDIANCUT, dither=Image.Dither.NONE
+    )
+    palette = quantized.getpalette()
+    used = sorted(quantized.getcolors(), reverse=True)
+    result = [
+        tuple(palette[index * 3 : index * 3 + 3])
+        for _, index in used[:colors]
+    ]
+    whitest = max(range(len(result)), key=lambda i: sum(result[i]))
+    result[whitest] = (255, 255, 255)
+    return list(dict.fromkeys(result))
+
+
+def reference_palette(image, colors=32):
+    rgb = np.asarray(image.convert("RGB"), dtype=np.uint8).reshape(-1, 3)
+    unique, counts = np.unique(rgb, axis=0, return_counts=True)
+    if len(unique) <= colors:
+        order = np.argsort(counts)[::-1]
+        palette = [tuple(map(int, color)) for color in unique[order]]
+    else:
+        palette = adaptive_palette(image, colors)
+    if (255, 255, 255) not in palette:
+        palette = [(255, 255, 255), *palette[: colors - 1]]
+    return palette[:colors]
+
+
+def indexed_image(image, palette):
+    palette = palette[:32]
+    pixels = np.asarray(image.convert("RGB"), dtype=np.int16)
+    colors = np.asarray(palette, dtype=np.int16)
+    flat = pixels.reshape(-1, 3)
+    indexes = np.empty(len(flat), dtype=np.uint8)
+    for start in range(0, len(flat), 65536):
+        chunk = flat[start : start + 65536].astype(np.int32)
+        delta = chunk[:, None] - colors[None].astype(np.int32)
+        distance = (delta**2).sum(axis=2)
+        indexes[start : start + len(chunk)] = distance.argmin(axis=1)
+    result = Image.fromarray(indexes.reshape(pixels.shape[:2]), "P")
+    padded = [channel for color in palette for channel in color]
+    padded.extend([channel for _ in range(32 - len(palette)) for channel in palette[-1]])
+    result.putpalette(padded + [0] * (768 - len(padded)))
+    return result
+
+
+def native_size(task):
+    return (256, 128) if task in SHEET_TASKS else (64, 64)
+
+
+def perfect_pixel_image(image, task):
+    expected = native_size(task)
+    if image.size == expected:
+        return image.convert("RGB")
+    width, height, refined = get_perfect_pixel(
+        np.asarray(image.convert("RGB")),
+        sample_method="median",
+        min_size=4.0,
+        peak_width=6,
+        refine_intensity=0.25,
+        fix_square=True,
+    )
+    if width is None or height is None:
+        raise ValueError("Perfect Pixel이 이미지의 픽셀 격자를 찾지 못했습니다.")
+    if (width, height) != expected:
+        raise ValueError(
+            f"Perfect Pixel 검출 크기는 {width}×{height}이지만 "
+            f"이 작업에는 {expected[0]}×{expected[1]} 격자가 필요합니다."
+        )
+    return Image.fromarray(np.asarray(refined, dtype=np.uint8), "RGB")
+
+
+def shared_palette(paths, colors=32):
+    images = [Image.open(path).convert("RGB") for path in paths]
+    if not images:
+        raise ValueError("공통 팔레트를 만들 이미지가 없습니다.")
+    width = max(image.width for image in images)
+    height = sum(image.height for image in images)
+    combined = Image.new("RGB", (width, height), "white")
+    y = 0
+    for image in images:
+        combined.paste(image, (0, y))
+        y += image.height
+    return adaptive_palette(combined, colors)
+
+
+def apply_shared_palette(paths, palette):
+    results = []
+    for path in paths:
+        image = indexed_image(Image.open(path).convert("RGB"), palette)
+        output = tempfile.NamedTemporaryFile(delete=False, suffix=".png").name
+        image.save(output, bits=5)
+        results.append(output)
+    return results
+
+
+def save_gif(sheet, palette, fps):
+    frame_width = sheet.width // COLUMNS
+    frame_height = sheet.height // ROWS
+    frames = []
+    for row in range(ROWS):
+        for column in range(COLUMNS):
+            frame = sheet.crop(
+                (
+                    column * frame_width,
+                    row * frame_height,
+                    (column + 1) * frame_width,
+                    (row + 1) * frame_height,
+                )
+            )
+            frames.append(indexed_image(frame.convert("RGB"), palette))
+    path = tempfile.NamedTemporaryFile(delete=False, suffix=".gif").name
+    frames[0].save(
+        path,
+        save_all=True,
+        append_images=frames[1:],
+        duration=round(1000 / fps),
+        loop=0,
+        disposal=2,
+    )
+    return path
+
+
+def process_output(
+    generated_path,
+    input_path,
+    task,
+    palette_reference_path,
+    palette_mode,
+    align_frames,
+    pixel_snap,
+    output_resolution,
+    output_format,
+    fps,
+):
+    generated = Image.open(generated_path).convert("RGB")
+    reference = Image.open(input_path).convert("RGB")
+    sheet_task = task in SHEET_TASKS
+    if align_frames and sheet_task:
+        generated = align_4x2(generated, reference)
+
+    target_native = native_size(task)
+    if pixel_snap:
+        working = perfect_pixel_image(generated, task)
+    elif output_resolution == "Native LPC":
+        working = generated.resize(target_native, Image.Resampling.NEAREST)
+    else:
+        working = generated
+
+    if palette_mode == "Defer shared palette":
+        palette = None
+    elif palette_mode == "Lock reference palette":
+        palette_source = Image.open(palette_reference_path).convert("RGB") if palette_reference_path else reference
+        palette_source = palette_source.resize(target_native, Image.Resampling.NEAREST)
+        palette = reference_palette(palette_source)
+    else:
+        palette = adaptive_palette(working)
+    if palette:
+        working = indexed_image(working, palette)
+
+    if output_resolution == "Upscaled" and working.size != generated.size:
+        working = working.resize(generated.size, Image.Resampling.NEAREST)
+    if output_format == "GIF":
+        if not sheet_task:
+            raise ValueError("GIF output is available for 4x2 sheet tasks.")
+        if not palette:
+            raise ValueError("공통 팔레트 적용 전에는 GIF를 만들 수 없습니다.")
+        return save_gif(working, palette, fps)
+
+    path = tempfile.NamedTemporaryFile(delete=False, suffix=".png").name
+    working.save(path, bits=5)
+    return path
+
+
+def self_check():
+    sheet = Image.new("RGB", (256, 128), "white")
+    array = np.asarray(sheet).copy()
+    for index in range(8):
+        row, column = divmod(index, 4)
+        array[row * 64 + 20 : row * 64 + 60, column * 64 + 24 : column * 64 + 40] = (
+            index * 20,
+            80,
+            160,
+        )
+    palette = adaptive_palette(Image.fromarray(array))
+    indexed = indexed_image(Image.fromarray(array), palette)
+    assert len(indexed.getcolors()) <= 32
+    rng = np.random.default_rng(7)
+    test_colors = np.asarray(
+        [(255, 255, 255), (20, 30, 40), (50, 90, 160), (200, 120, 80)],
+        dtype=np.uint8,
+    )
+    test_grid = test_colors[rng.integers(0, len(test_colors), size=(128, 256))]
+    upscaled = Image.fromarray(test_grid).resize(
+        (2048, 1024), Image.Resampling.NEAREST
+    )
+    assert perfect_pixel_image(upscaled, "Propagate frame 1 appearance").size == (
+        256,
+        128,
+    )
+    gif = save_gif(indexed, palette, 8)
+    with Image.open(gif) as animation:
+        assert animation.n_frames == 8
+    Path(gif).unlink()
+    print("postprocess self-check passed")
+
+
+if __name__ == "__main__":
+    self_check()

publish_github.ps1

@@ -0,0 +1,57 @@
+param(
+    [string]$Owner = "Baragi-AI",
+    [string]$Repository = "LPC-FourDirection-Walk-Flux-Klein-9B",
+    [ValidateSet("public", "private")]
+    [string]$Visibility = "public"
+)
+
+$ErrorActionPreference = "Stop"
+$slug = "$Owner/$Repository"
+Set-Location -LiteralPath $PSScriptRoot
+$repoPath = (Resolve-Path -LiteralPath $PSScriptRoot).Path.Replace("\", "/")
+$safeDirectories = @(git config --global --get-all safe.directory 2>$null)
+if ($safeDirectories -notcontains $repoPath) {
+    git config --global --add safe.directory $repoPath
+    if ($LASTEXITCODE -ne 0) { throw "Could not register the repository as a safe directory." }
+}
+
+gh auth status 2>$null
+if ($LASTEXITCODE -ne 0) {
+    gh auth login -h github.com -p https -w
+    if ($LASTEXITCODE -ne 0) { throw "GitHub authentication failed." }
+}
+
+$insideRepo = git rev-parse --is-inside-work-tree 2>$null
+if ($LASTEXITCODE -ne 0 -or $insideRepo -ne "true") {
+    throw "Run this script from the release repository directory."
+}
+
+if (git status --porcelain) {
+    throw "The working tree is not clean. Commit the changes before publishing."
+}
+
+$branch = git branch --show-current
+if ($branch -ne "main") {
+    throw "Expected branch 'main', found '$branch'."
+}
+
+gh repo view $slug --json nameWithOwner 2>$null | Out-Null
+if ($LASTEXITCODE -ne 0) {
+    gh repo create $slug "--$Visibility" --source . --remote origin --push `
+        --description "FLUX.2 Klein 9B LoRA for female LPC four-direction walking sprites"
+    if ($LASTEXITCODE -ne 0) { throw "Repository creation or initial push failed." }
+}
+else {
+    $remote = git remote get-url origin 2>$null
+    if ($LASTEXITCODE -eq 0) {
+        git remote set-url origin "https://github.com/$slug.git"
+    }
+    else {
+        git remote add origin "https://github.com/$slug.git"
+    }
+    git push -u origin main
+    if ($LASTEXITCODE -ne 0) { throw "Push failed." }
+}
+
+gh repo view $slug --web
+Write-Host "Published: https://github.com/$slug"

requirements.txt

@@ -0,0 +1,6 @@
+gradio>=6,<7
+numpy>=1.24,<3
+Pillow>=10
+perfect-pixel==0.1.4
+python-dotenv>=1.0
+requests>=2.31

workflows/LPC_FourDirection_Walk_API.json

@@ -0,0 +1,148 @@
+{
+  "1": {
+    "class_type": "LoadImage",
+    "inputs": {
+      "image": "input.png"
+    }
+  },
+  "2": {
+    "class_type": "ImageScaleToTotalPixels",
+    "inputs": {
+      "image": ["1", 0],
+      "upscale_method": "lanczos",
+      "megapixels": 1.0,
+      "resolution_steps": 1
+    }
+  },
+  "3": {
+    "class_type": "UNETLoader",
+    "inputs": {
+      "unet_name": "flux-2-klein-base-9b-fp8.safetensors",
+      "weight_dtype": "default"
+    }
+  },
+  "4": {
+    "class_type": "LoraLoaderModelOnly",
+    "inputs": {
+      "model": ["3", 0],
+      "lora_name": "Baragi-AI__LPC-FourDirection-Walk-Flux-Klein-9B__LPC_FourDirection_Walk_ComfyUI.safetensors",
+      "strength_model": 1.0
+    }
+  },
+  "5": {
+    "class_type": "CLIPLoader",
+    "inputs": {
+      "clip_name": "qwen_3_8b_fp8mixed.safetensors",
+      "type": "flux2",
+      "device": "default"
+    }
+  },
+  "6": {
+    "class_type": "VAELoader",
+    "inputs": {
+      "vae_name": "full_encoder_small_decoder.safetensors"
+    }
+  },
+  "7": {
+    "class_type": "GetImageSize",
+    "inputs": {
+      "image": ["2", 0]
+    }
+  },
+  "8": {
+    "class_type": "EmptyFlux2LatentImage",
+    "inputs": {
+      "width": ["7", 0],
+      "height": ["7", 1],
+      "batch_size": 1
+    }
+  },
+  "9": {
+    "class_type": "CLIPTextEncode",
+    "inputs": {
+      "text": "TASK_ROTATE_STANDING: Turn the south-facing standing female LPC character to face north. Preserve the exact hairstyle, hair color, clothing, shoes and accessories. Keep the character centered on a pure white background.",
+      "clip": ["5", 0]
+    }
+  },
+  "10": {
+    "class_type": "CLIPTextEncode",
+    "inputs": {
+      "text": "",
+      "clip": ["5", 0]
+    }
+  },
+  "11": {
+    "class_type": "VAEEncode",
+    "inputs": {
+      "pixels": ["2", 0],
+      "vae": ["6", 0]
+    }
+  },
+  "12": {
+    "class_type": "ReferenceLatent",
+    "inputs": {
+      "conditioning": ["9", 0],
+      "latent": ["11", 0]
+    }
+  },
+  "13": {
+    "class_type": "ReferenceLatent",
+    "inputs": {
+      "conditioning": ["10", 0],
+      "latent": ["11", 0]
+    }
+  },
+  "14": {
+    "class_type": "RandomNoise",
+    "inputs": {
+      "noise_seed": 710001
+    }
+  },
+  "15": {
+    "class_type": "Flux2Scheduler",
+    "inputs": {
+      "steps": 28,
+      "width": ["7", 0],
+      "height": ["7", 1]
+    }
+  },
+  "16": {
+    "class_type": "KSamplerSelect",
+    "inputs": {
+      "sampler_name": "euler"
+    }
+  },
+  "17": {
+    "class_type": "CFGGuider",
+    "inputs": {
+      "model": ["4", 0],
+      "positive": ["12", 0],
+      "negative": ["13", 0],
+      "cfg": 5.0
+    }
+  },
+  "18": {
+    "class_type": "SamplerCustomAdvanced",
+    "inputs": {
+      "noise": ["14", 0],
+      "guider": ["17", 0],
+      "sampler": ["16", 0],
+      "sigmas": ["15", 0],
+      "latent_image": ["8", 0]
+    }
+  },
+  "19": {
+    "class_type": "VAEDecode",
+    "inputs": {
+      "samples": ["18", 0],
+      "vae": ["6", 0]
+    }
+  },
+  "20": {
+    "class_type": "SaveImage",
+    "inputs": {
+      "images": ["19", 0],
+      "filename_prefix": "LPC_FourDirection_Walk"
+    }
+  }
+}

workflows/LPC_FourDirection_Walk_ComfyUI.json

@@ -0,0 +1,1413 @@
+{
+  "id": "30f91c3a-3480-4a30-9d15-lpc-four-direction-walk",
+  "revision": 0,
+  "last_node_id": 210,
+  "last_link_id": 202,
+  "nodes": [
+    {
+      "id": 61,
+      "type": "KSamplerSelect",
+      "pos": [
+        1200,
+        360
+      ],
+      "size": [
+        270,
+        110
+      ],
+      "flags": {},
+      "order": 0,
+      "mode": 0,
+      "inputs": [],
+      "outputs": [
+        {
+          "localized_name": "SAMPLER",
+          "name": "SAMPLER",
+          "type": "SAMPLER",
+          "links": [
+            144
+          ]
+        }
+      ],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.8.2",
+        "Node name for S&R": "KSamplerSelect",
+        "enableTabs": false,
+        "tabWidth": 65,
+        "tabXOffset": 10,
+        "hasSecondTab": false,
+        "secondTabText": "Send Back",
+        "secondTabOffset": 80,
+        "secondTabWidth": 65,
+        "ue_properties": {
+          "widget_ue_connectable": {},
+          "version": "7.7",
+          "input_ue_unconnectable": {}
+        }
+      },
+      "widgets_values": [
+        "euler"
+      ]
+    },
+    {
+      "id": 62,
+      "type": "Flux2Scheduler",
+      "pos": [
+        1200,
+        180
+      ],
+      "size": [
+        270,
+        170
+      ],
+      "flags": {},
+      "order": 1,
+      "mode": 0,
+      "inputs": [
+        {
+          "localized_name": "width",
+          "name": "width",
+          "type": "INT",
+          "widget": {
+            "name": "width"
+          },
+          "link": 171
+        },
+        {
+          "localized_name": "height",
+          "name": "height",
+          "type": "INT",
+          "widget": {
+            "name": "height"
+          },
+          "link": 173
+        }
+      ],
+      "outputs": [
+        {
+          "localized_name": "SIGMAS",
+          "name": "SIGMAS",
+          "type": "SIGMAS",
+          "links": [
+            145
+          ]
+        }
+      ],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.8.2",
+        "Node name for S&R": "Flux2Scheduler",
+        "enableTabs": false,
+        "tabWidth": 65,
+        "tabXOffset": 10,
+        "hasSecondTab": false,
+        "secondTabText": "Send Back",
+        "secondTabOffset": 80,
+        "secondTabWidth": 65,
+        "ue_properties": {
+          "widget_ue_connectable": {},
+          "version": "7.7",
+          "input_ue_unconnectable": {}
+        }
+      },
+      "widgets_values": [
+        28,
+        1024,
+        1024
+      ]
+    },
+    {
+      "id": 63,
+      "type": "CFGGuider",
+      "pos": [
+        1200,
+        650
+      ],
+      "size": [
+        270,
+        160
+      ],
+      "flags": {},
+      "order": 2,
+      "mode": 0,
+      "inputs": [
+        {
+          "localized_name": "model",
+          "name": "model",
+          "type": "MODEL",
+          "link": 139
+        },
+        {
+          "localized_name": "positive",
+          "name": "positive",
+          "type": "CONDITIONING",
+          "link": 197
+        },
+        {
+          "localized_name": "negative",
+          "name": "negative",
+          "type": "CONDITIONING",
+          "link": 198
+        }
+      ],
+      "outputs": [
+        {
+          "localized_name": "GUIDER",
+          "name": "GUIDER",
+          "type": "GUIDER",
+          "links": [
+            143
+          ]
+        }
+      ],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.8.2",
+        "Node name for S&R": "CFGGuider",
+        "enableTabs": false,
+        "tabWidth": 65,
+        "tabXOffset": 10,
+        "hasSecondTab": false,
+        "secondTabText": "Send Back",
+        "secondTabOffset": 80,
+        "secondTabWidth": 65,
+        "ue_properties": {
+          "widget_ue_connectable": {},
+          "version": "7.7",
+          "input_ue_unconnectable": {}
+        }
+      },
+      "widgets_values": [
+        5
+      ]
+    },
+    {
+      "id": 64,
+      "type": "SamplerCustomAdvanced",
+      "pos": [
+        1550,
+        500
+      ],
+      "size": [
+        230,
+        170
+      ],
+      "flags": {},
+      "order": 3,
+      "mode": 0,
+      "inputs": [
+        {
+          "localized_name": "noise",
+          "name": "noise",
+          "type": "NOISE",
+          "link": 142
+        },
+        {
+          "localized_name": "guider",
+          "name": "guider",
+          "type": "GUIDER",
+          "link": 143
+        },
+        {
+          "localized_name": "sampler",
+          "name": "sampler",
+          "type": "SAMPLER",
+          "link": 144
+        },
+        {
+          "localized_name": "sigmas",
+          "name": "sigmas",
+          "type": "SIGMAS",
+          "link": 145
+        },
+        {
+          "localized_name": "latent_image",
+          "name": "latent_image",
+          "type": "LATENT",
+          "link": 146
+        }
+      ],
+      "outputs": [
+        {
+          "localized_name": "output",
+          "name": "output",
+          "type": "LATENT",
+          "links": [
+            147
+          ]
+        },
+        {
+          "localized_name": "denoised_output",
+          "name": "denoised_output",
+          "type": "LATENT",
+          "links": []
+        }
+      ],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.8.2",
+        "Node name for S&R": "SamplerCustomAdvanced",
+        "enableTabs": false,
+        "tabWidth": 65,
+        "tabXOffset": 10,
+        "hasSecondTab": false,
+        "secondTabText": "Send Back",
+        "secondTabOffset": 80,
+        "secondTabWidth": 65,
+        "ue_properties": {
+          "widget_ue_connectable": {},
+          "version": "7.7",
+          "input_ue_unconnectable": {}
+        }
+      },
+      "widgets_values": []
+    },
+    {
+      "id": 65,
+      "type": "VAEDecode",
+      "pos": [
+        1900,
+        500
+      ],
+      "size": [
+        230,
+        100
+      ],
+      "flags": {},
+      "order": 4,
+      "mode": 0,
+      "inputs": [
+        {
+          "localized_name": "samples",
+          "name": "samples",
+          "type": "LATENT",
+          "link": 147
+        },
+        {
+          "localized_name": "vae",
+          "name": "vae",
+          "type": "VAE",
+          "link": 148
+        }
+      ],
+      "outputs": [
+        {
+          "localized_name": "IMAGE",
+          "name": "IMAGE",
+          "type": "IMAGE",
+          "slot_index": 0,
+          "links": [
+            201
+          ]
+        }
+      ],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.8.2",
+        "Node name for S&R": "VAEDecode",
+        "enableTabs": false,
+        "tabWidth": 65,
+        "tabXOffset": 10,
+        "hasSecondTab": false,
+        "secondTabText": "Send Back",
+        "secondTabOffset": 80,
+        "secondTabWidth": 65,
+        "ue_properties": {
+          "widget_ue_connectable": {},
+          "version": "7.7",
+          "input_ue_unconnectable": {}
+        }
+      },
+      "widgets_values": []
+    },
+    {
+      "id": 73,
+      "type": "RandomNoise",
+      "pos": [
+        1200,
+        0
+      ],
+      "size": [
+        270,
+        110
+      ],
+      "flags": {},
+      "order": 5,
+      "mode": 0,
+      "inputs": [],
+      "outputs": [
+        {
+          "localized_name": "NOISE",
+          "name": "NOISE",
+          "type": "NOISE",
+          "links": [
+            142
+          ]
+        }
+      ],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.8.2",
+        "Node name for S&R": "RandomNoise",
+        "enableTabs": false,
+        "tabWidth": 65,
+        "tabXOffset": 10,
+        "hasSecondTab": false,
+        "secondTabText": "Send Back",
+        "secondTabOffset": 80,
+        "secondTabWidth": 65,
+        "ue_properties": {
+          "widget_ue_connectable": {},
+          "version": "7.7",
+          "input_ue_unconnectable": {}
+        }
+      },
+      "widgets_values": [
+        710001,
+        "fixed"
+      ]
+    },
+    {
+      "id": 70,
+      "type": "UNETLoader",
+      "pos": [
+        0,
+        400
+      ],
+      "size": [
+        370,
+        110
+      ],
+      "flags": {},
+      "order": 6,
+      "mode": 0,
+      "inputs": [],
+      "outputs": [
+        {
+          "localized_name": "MODEL",
+          "name": "MODEL",
+          "type": "MODEL",
+          "links": [
+            202
+          ]
+        }
+      ],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.8.2",
+        "Node name for S&R": "UNETLoader",
+        "enableTabs": false,
+        "tabWidth": 65,
+        "tabXOffset": 10,
+        "hasSecondTab": false,
+        "secondTabText": "Send Back",
+        "secondTabOffset": 80,
+        "secondTabWidth": 65,
+        "models": [
+          {
+            "name": "flux-2-klein-base-9b-fp8.safetensors",
+            "url": "https://huggingface.co/black-forest-labs/FLUX.2-klein-base-9b-fp8/resolve/main/flux-2-klein-base-9b-fp8.safetensors",
+            "directory": "diffusion_models"
+          }
+        ],
+        "ue_properties": {
+          "widget_ue_connectable": {},
+          "version": "7.7",
+          "input_ue_unconnectable": {}
+        }
+      },
+      "widgets_values": [
+        "flux-2-klein-base-9b-fp8.safetensors",
+        "default"
+      ]
+    },
+    {
+      "id": 71,
+      "type": "CLIPLoader",
+      "pos": [
+        0,
+        650
+      ],
+      "size": [
+        370,
+        150
+      ],
+      "flags": {},
+      "order": 7,
+      "mode": 0,
+      "inputs": [],
+      "outputs": [
+        {
+          "localized_name": "CLIP",
+          "name": "CLIP",
+          "type": "CLIP",
+          "links": [
+            151,
+            152
+          ]
+        }
+      ],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.8.2",
+        "Node name for S&R": "CLIPLoader",
+        "enableTabs": false,
+        "tabWidth": 65,
+        "tabXOffset": 10,
+        "hasSecondTab": false,
+        "secondTabText": "Send Back",
+        "secondTabOffset": 80,
+        "secondTabWidth": 65,
+        "models": [
+          {
+            "name": "qwen_3_8b_fp8mixed.safetensors",
+            "url": "https://huggingface.co/Comfy-Org/flux2-klein-9B/resolve/main/split_files/text_encoders/qwen_3_8b_fp8mixed.safetensors",
+            "directory": "text_encoders"
+          }
+        ],
+        "ue_properties": {
+          "widget_ue_connectable": {},
+          "version": "7.7",
+          "input_ue_unconnectable": {}
+        }
+      },
+      "widgets_values": [
+        "qwen_3_8b_fp8mixed.safetensors",
+        "flux2",
+        "default"
+      ]
+    },
+    {
+      "id": 74,
+      "type": "CLIPTextEncode",
+      "pos": [
+        450,
+        650
+      ],
+      "size": [
+        450,
+        480
+      ],
+      "flags": {},
+      "order": 8,
+      "mode": 0,
+      "inputs": [
+        {
+          "localized_name": "clip",
+          "name": "clip",
+          "type": "CLIP",
+          "link": 151
+        }
+      ],
+      "outputs": [
+        {
+          "localized_name": "CONDITIONING",
+          "name": "CONDITIONING",
+          "type": "CONDITIONING",
+          "slot_index": 0,
+          "links": [
+            193
+          ]
+        }
+      ],
+      "title": "CLIP Text Encode (Positive Prompt)",
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.8.2",
+        "Node name for S&R": "CLIPTextEncode",
+        "enableTabs": false,
+        "tabWidth": 65,
+        "tabXOffset": 10,
+        "hasSecondTab": false,
+        "secondTabText": "Send Back",
+        "secondTabOffset": 80,
+        "secondTabWidth": 65,
+        "ue_properties": {
+          "widget_ue_connectable": {},
+          "version": "7.7",
+          "input_ue_unconnectable": {}
+        }
+      },
+      "widgets_values": [
+        "TASK_PROPAGATE_APPEARANCE: Use frame 1 as the appearance reference. Apply exactly the same hairstyle, hair color, clothing, shoes and accessories to frames 2 through 8. Preserve every walking pose, frame order, 4 by 2 layout and pure white background."
+      ],
+      "color": "#232",
+      "bgcolor": "#353"
+    },
+    {
+      "id": 67,
+      "type": "CLIPTextEncode",
+      "pos": [
+        450,
+        900
+      ],
+      "size": [
+        430,
+        140
+      ],
+      "flags": {},
+      "order": 9,
+      "mode": 0,
+      "inputs": [
+        {
+          "localized_name": "clip",
+          "name": "clip",
+          "type": "CLIP",
+          "link": 152
+        }
+      ],
+      "outputs": [
+        {
+          "localized_name": "CONDITIONING",
+          "name": "CONDITIONING",
+          "type": "CONDITIONING",
+          "slot_index": 0,
+          "links": [
+            194
+          ]
+        }
+      ],
+      "title": "CLIP Text Encode (Negative Prompt)",
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.8.2",
+        "Node name for S&R": "CLIPTextEncode",
+        "enableTabs": false,
+        "tabWidth": 65,
+        "tabXOffset": 10,
+        "hasSecondTab": false,
+        "secondTabText": "Send Back",
+        "secondTabOffset": 80,
+        "secondTabWidth": 65,
+        "ue_properties": {
+          "widget_ue_connectable": {},
+          "version": "7.7",
+          "input_ue_unconnectable": {}
+        }
+      },
+      "widgets_values": [
+        ""
+      ],
+      "color": "#322",
+      "bgcolor": "#533"
+    },
+    {
+      "id": 72,
+      "type": "VAELoader",
+      "pos": [
+        0,
+        900
+      ],
+      "size": [
+        370,
+        110
+      ],
+      "flags": {},
+      "order": 10,
+      "mode": 0,
+      "inputs": [],
+      "outputs": [
+        {
+          "localized_name": "VAE",
+          "name": "VAE",
+          "type": "VAE",
+          "links": [
+            148,
+            196
+          ]
+        }
+      ],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.8.2",
+        "Node name for S&R": "VAELoader",
+        "enableTabs": false,
+        "tabWidth": 65,
+        "tabXOffset": 10,
+        "hasSecondTab": false,
+        "secondTabText": "Send Back",
+        "secondTabOffset": 80,
+        "secondTabWidth": 65,
+        "models": [
+          {
+            "name": "full_encoder_small_decoder.safetensors",
+            "url": "https://huggingface.co/black-forest-labs/FLUX.2-small-decoder/resolve/main/full_encoder_small_decoder.safetensors",
+            "directory": "vae"
+          }
+        ],
+        "ue_properties": {
+          "widget_ue_connectable": {},
+          "version": "7.7",
+          "input_ue_unconnectable": {}
+        }
+      },
+      "widgets_values": [
+        "full_encoder_small_decoder.safetensors"
+      ]
+    },
+    {
+      "id": 66,
+      "type": "EmptyFlux2LatentImage",
+      "pos": [
+        1000,
+        0
+      ],
+      "size": [
+        270,
+        170
+      ],
+      "flags": {},
+      "order": 11,
+      "mode": 0,
+      "inputs": [
+        {
+          "localized_name": "width",
+          "name": "width",
+          "type": "INT",
+          "widget": {
+            "name": "width"
+          },
+          "link": 172
+        },
+        {
+          "localized_name": "height",
+          "name": "height",
+          "type": "INT",
+          "widget": {
+            "name": "height"
+          },
+          "link": 174
+        }
+      ],
+      "outputs": [
+        {
+          "localized_name": "LATENT",
+          "name": "LATENT",
+          "type": "LATENT",
+          "links": [
+            146
+          ]
+        }
+      ],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.8.2",
+        "Node name for S&R": "EmptyFlux2LatentImage",
+        "enableTabs": false,
+        "tabWidth": 65,
+        "tabXOffset": 10,
+        "hasSecondTab": false,
+        "secondTabText": "Send Back",
+        "secondTabOffset": 80,
+        "secondTabWidth": 65,
+        "ue_properties": {
+          "widget_ue_connectable": {},
+          "version": "7.7",
+          "input_ue_unconnectable": {}
+        }
+      },
+      "widgets_values": [
+        1024,
+        1024,
+        1
+      ]
+    },
+    {
+      "id": 80,
+      "type": "ImageScaleToTotalPixels",
+      "pos": [
+        350,
+        0
+      ],
+      "size": [
+        270,
+        140
+      ],
+      "flags": {},
+      "order": 12,
+      "mode": 0,
+      "inputs": [
+        {
+          "localized_name": "image",
+          "name": "image",
+          "type": "IMAGE",
+          "link": 200
+        }
+      ],
+      "outputs": [
+        {
+          "localized_name": "IMAGE",
+          "name": "IMAGE",
+          "type": "IMAGE",
+          "links": [
+            170,
+            195
+          ]
+        }
+      ],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.8.2",
+        "Node name for S&R": "ImageScaleToTotalPixels",
+        "enableTabs": false,
+        "tabWidth": 65,
+        "tabXOffset": 10,
+        "hasSecondTab": false,
+        "secondTabText": "Send Back",
+        "secondTabOffset": 80,
+        "secondTabWidth": 65,
+        "ue_properties": {
+          "widget_ue_connectable": {},
+          "version": "7.7",
+          "input_ue_unconnectable": {}
+        }
+      },
+      "widgets_values": [
+        "lanczos",
+        2,
+        1
+      ]
+    },
+    {
+      "id": 100,
+      "type": "GetImageSize",
+      "pos": [
+        700,
+        0
+      ],
+      "size": [
+        230,
+        120
+      ],
+      "flags": {},
+      "order": 13,
+      "mode": 0,
+      "inputs": [
+        {
+          "localized_name": "image",
+          "name": "image",
+          "type": "IMAGE",
+          "link": 170
+        }
+      ],
+      "outputs": [
+        {
+          "localized_name": "width",
+          "name": "width",
+          "type": "INT",
+          "links": [
+            171,
+            172
+          ]
+        },
+        {
+          "localized_name": "height",
+          "name": "height",
+          "type": "INT",
+          "links": [
+            173,
+            174
+          ]
+        },
+        {
+          "localized_name": "batch_size",
+          "name": "batch_size",
+          "type": "INT",
+          "links": null
+        }
+      ],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.8.2",
+        "Node name for S&R": "GetImageSize",
+        "enableTabs": false,
+        "tabWidth": 65,
+        "tabXOffset": 10,
+        "hasSecondTab": false,
+        "secondTabText": "Send Back",
+        "secondTabOffset": 80,
+        "secondTabWidth": 65,
+        "ue_properties": {
+          "widget_ue_connectable": {},
+          "version": "7.7",
+          "input_ue_unconnectable": {}
+        }
+      },
+      "widgets_values": []
+    },
+    {
+      "id": 122,
+      "type": "ReferenceLatent",
+      "pos": [
+        850,
+        900
+      ],
+      "size": [
+        230,
+        100
+      ],
+      "flags": {
+        "collapsed": false
+      },
+      "order": 14,
+      "mode": 0,
+      "inputs": [
+        {
+          "localized_name": "conditioning",
+          "name": "conditioning",
+          "type": "CONDITIONING",
+          "link": 194
+        },
+        {
+          "localized_name": "latent",
+          "name": "latent",
+          "shape": 7,
+          "type": "LATENT",
+          "link": 191
+        }
+      ],
+      "outputs": [
+        {
+          "localized_name": "CONDITIONING",
+          "name": "CONDITIONING",
+          "type": "CONDITIONING",
+          "links": [
+            198
+          ]
+        }
+      ],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.8.2",
+        "Node name for S&R": "ReferenceLatent",
+        "enableTabs": false,
+        "tabWidth": 65,
+        "tabXOffset": 10,
+        "hasSecondTab": false,
+        "secondTabText": "Send Back",
+        "secondTabOffset": 80,
+        "secondTabWidth": 65,
+        "ue_properties": {
+          "widget_ue_connectable": {},
+          "version": "7.7",
+          "input_ue_unconnectable": {}
+        }
+      },
+      "widgets_values": []
+    },
+    {
+      "id": 123,
+      "type": "VAEEncode",
+      "pos": [
+        800,
+        180
+      ],
+      "size": [
+        230,
+        100
+      ],
+      "flags": {
+        "collapsed": false
+      },
+      "order": 15,
+      "mode": 0,
+      "inputs": [
+        {
+          "localized_name": "pixels",
+          "name": "pixels",
+          "type": "IMAGE",
+          "link": 195
+        },
+        {
+          "localized_name": "vae",
+          "name": "vae",
+          "type": "VAE",
+          "link": 196
+        }
+      ],
+      "outputs": [
+        {
+          "localized_name": "LATENT",
+          "name": "LATENT",
+          "type": "LATENT",
+          "links": [
+            191,
+            192
+          ]
+        }
+      ],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.8.2",
+        "Node name for S&R": "VAEEncode",
+        "enableTabs": false,
+        "tabWidth": 65,
+        "tabXOffset": 10,
+        "hasSecondTab": false,
+        "secondTabText": "Send Back",
+        "secondTabOffset": 80,
+        "secondTabWidth": 65,
+        "ue_properties": {
+          "widget_ue_connectable": {},
+          "version": "7.7",
+          "input_ue_unconnectable": {}
+        }
+      },
+      "widgets_values": []
+    },
+    {
+      "id": 124,
+      "type": "ReferenceLatent",
+      "pos": [
+        850,
+        650
+      ],
+      "size": [
+        230,
+        100
+      ],
+      "flags": {
+        "collapsed": false
+      },
+      "order": 16,
+      "mode": 0,
+      "inputs": [
+        {
+          "localized_name": "conditioning",
+          "name": "conditioning",
+          "type": "CONDITIONING",
+          "link": 193
+        },
+        {
+          "localized_name": "latent",
+          "name": "latent",
+          "shape": 7,
+          "type": "LATENT",
+          "link": 192
+        }
+      ],
+      "outputs": [
+        {
+          "localized_name": "CONDITIONING",
+          "name": "CONDITIONING",
+          "type": "CONDITIONING",
+          "links": [
+            197
+          ]
+        }
+      ],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.8.2",
+        "Node name for S&R": "ReferenceLatent",
+        "enableTabs": false,
+        "tabWidth": 65,
+        "tabXOffset": 10,
+        "hasSecondTab": false,
+        "secondTabText": "Send Back",
+        "secondTabOffset": 80,
+        "secondTabWidth": 65,
+        "ue_properties": {
+          "widget_ue_connectable": {},
+          "version": "7.7",
+          "input_ue_unconnectable": {}
+        }
+      },
+      "widgets_values": []
+    },
+    {
+      "id": 76,
+      "type": "LoadImage",
+      "pos": [
+        0,
+        0
+      ],
+      "size": [
+        320,
+        470
+      ],
+      "flags": {},
+      "order": 17,
+      "mode": 0,
+      "inputs": [],
+      "outputs": [
+        {
+          "name": "IMAGE",
+          "type": "IMAGE",
+          "links": [
+            200
+          ]
+        },
+        {
+          "name": "MASK",
+          "type": "MASK",
+          "links": null
+        }
+      ],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.8.2",
+        "Node name for S&R": "LoadImage",
+        "enableTabs": false,
+        "tabWidth": 65,
+        "tabXOffset": 10,
+        "hasSecondTab": false,
+        "secondTabText": "Send Back",
+        "secondTabOffset": 80,
+        "secondTabWidth": 65,
+        "ue_properties": {
+          "widget_ue_connectable": {},
+          "version": "7.7",
+          "input_ue_unconnectable": {}
+        }
+      },
+      "widgets_values": [
+        "input.png",
+        "image"
+      ]
+    },
+    {
+      "id": 9,
+      "type": "SaveImage",
+      "pos": [
+        2200,
+        500
+      ],
+      "size": [
+        420,
+        470
+      ],
+      "flags": {},
+      "order": 18,
+      "mode": 0,
+      "inputs": [
+        {
+          "name": "images",
+          "type": "IMAGE",
+          "link": 201
+        }
+      ],
+      "outputs": [],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.8.2",
+        "enableTabs": false,
+        "tabWidth": 65,
+        "tabXOffset": 10,
+        "hasSecondTab": false,
+        "secondTabText": "Send Back",
+        "secondTabOffset": 80,
+        "secondTabWidth": 65,
+        "Node name for S&R": "SaveImage",
+        "ue_properties": {
+          "widget_ue_connectable": {},
+          "version": "7.7",
+          "input_ue_unconnectable": {}
+        }
+      },
+      "widgets_values": [
+        "LPC_FourDirection_Walk"
+      ]
+    },
+    {
+      "id": 131,
+      "type": "LoraLoaderModelOnly",
+      "pos": [
+        400,
+        400
+      ],
+      "size": [
+        410,
+        126
+      ],
+      "flags": {},
+      "order": 19,
+      "mode": 0,
+      "inputs": [
+        {
+          "localized_name": "model",
+          "name": "model",
+          "type": "MODEL",
+          "link": 202
+        }
+      ],
+      "outputs": [
+        {
+          "localized_name": "MODEL",
+          "name": "MODEL",
+          "type": "MODEL",
+          "links": [
+            139
+          ]
+        }
+      ],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.8.2",
+        "Node name for S&R": "LoraLoaderModelOnly",
+        "models": [
+          {
+            "name": "LPC_FourDirection_Walk_ComfyUI.safetensors",
+            "url": "https://huggingface.co/Baragi-AI/LPC-FourDirection-Walk-Flux-Klein-9B/resolve/main/LPC_FourDirection_Walk_ComfyUI.safetensors",
+            "directory": "loras"
+          }
+        ]
+      },
+      "widgets_values": [
+        "Baragi-AI__LPC-FourDirection-Walk-Flux-Klein-9B__LPC_FourDirection_Walk_ComfyUI.safetensors",
+        1.0
+      ]
+    },
+    {
+      "id": 210,
+      "type": "MarkdownNote",
+      "pos": [
+        0,
+        -400
+      ],
+      "size": [
+        1100,
+        320
+      ],
+      "flags": {},
+      "order": 20,
+      "mode": 0,
+      "inputs": [],
+      "outputs": [],
+      "properties": {},
+      "widgets_values": [
+        "# LPC Four-Direction Walk — FLUX.2 Klein 9B\n\nUse the ComfyUI-compatible LoRA file. Core nodes only; works on Comfy Cloud.\n\n**Task tokens:** `TASK_ROTATE_STANDING`, `TASK_STANDING_TO_WALK_FIRST_FRAME`, `TASK_PROPAGATE_APPEARANCE`, `TASK_DRESS_WALK_SHEET`, `TASK_DRESS_STANDING`\n\nUse 1 megapixel for standing/frame tasks and 2 megapixels for 4×2 sheet tasks. Recommended: strength 1.0, 28 steps, CFG 5, Euler. Keep the ReferenceLatent connected to both positive and negative conditioning."
+      ]
+    }
+  ],
+  "links": [
+    [
+      139,
+      131,
+      0,
+      63,
+      0,
+      "MODEL"
+    ],
+    [
+      142,
+      73,
+      0,
+      64,
+      0,
+      "NOISE"
+    ],
+    [
+      143,
+      63,
+      0,
+      64,
+      1,
+      "GUIDER"
+    ],
+    [
+      144,
+      61,
+      0,
+      64,
+      2,
+      "SAMPLER"
+    ],
+    [
+      145,
+      62,
+      0,
+      64,
+      3,
+      "SIGMAS"
+    ],
+    [
+      146,
+      66,
+      0,
+      64,
+      4,
+      "LATENT"
+    ],
+    [
+      147,
+      64,
+      0,
+      65,
+      0,
+      "LATENT"
+    ],
+    [
+      148,
+      72,
+      0,
+      65,
+      1,
+      "VAE"
+    ],
+    [
+      152,
+      71,
+      0,
+      67,
+      0,
+      "CLIP"
+    ],
+    [
+      151,
+      71,
+      0,
+      74,
+      0,
+      "CLIP"
+    ],
+    [
+      170,
+      80,
+      0,
+      100,
+      0,
+      "IMAGE"
+    ],
+    [
+      171,
+      100,
+      0,
+      62,
+      0,
+      "INT"
+    ],
+    [
+      172,
+      100,
+      0,
+      66,
+      0,
+      "INT"
+    ],
+    [
+      173,
+      100,
+      1,
+      62,
+      1,
+      "INT"
+    ],
+    [
+      174,
+      100,
+      1,
+      66,
+      1,
+      "INT"
+    ],
+    [
+      191,
+      123,
+      0,
+      122,
+      1,
+      "LATENT"
+    ],
+    [
+      192,
+      123,
+      0,
+      124,
+      1,
+      "LATENT"
+    ],
+    [
+      193,
+      74,
+      0,
+      124,
+      0,
+      "CONDITIONING"
+    ],
+    [
+      194,
+      67,
+      0,
+      122,
+      0,
+      "CONDITIONING"
+    ],
+    [
+      195,
+      80,
+      0,
+      123,
+      0,
+      "IMAGE"
+    ],
+    [
+      196,
+      72,
+      0,
+      123,
+      1,
+      "VAE"
+    ],
+    [
+      197,
+      124,
+      0,
+      63,
+      1,
+      "CONDITIONING"
+    ],
+    [
+      198,
+      122,
+      0,
+      63,
+      2,
+      "CONDITIONING"
+    ],
+    [
+      200,
+      76,
+      0,
+      80,
+      0,
+      "IMAGE"
+    ],
+    [
+      201,
+      65,
+      0,
+      9,
+      0,
+      "IMAGE"
+    ],
+    [
+      202,
+      70,
+      0,
+      131,
+      0,
+      "MODEL"
+    ]
+  ],
+  "groups": [],
+  "config": {},
+  "extra": {
+    "ds": {
+      "scale": 0.4616798782843073,
+      "offset": [
+        1426.9711107207381,
+        -133.46729532779628
+      ]
+    },
+    "frontendVersion": "1.42.10",
+    "workflowRendererVersion": "LG",
+    "VHS_latentpreview": false,
+    "VHS_latentpreviewrate": 0,
+    "VHS_MetadataImage": true,
+    "VHS_KeepIntermediate": true,
+    "ue_links": []
+  },
+  "version": 0.4
+}