Instructions to use Xabsurd/MOSS-Image-Tile-Control with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Diffusion Single File
How to use Xabsurd/MOSS-Image-Tile-Control with Diffusion Single File:
# No code snippets available yet for this library. # To use this model, check the repository files and the library's documentation. # Want to help? PRs adding snippets are welcome at: # https://github.com/huggingface/huggingface.js
- Notebooks
- Google Colab
- Kaggle
MOSS-Image Tile Control β V1
V1 is the recommended final release, developed through four design iterations. It uses MOSS-LLLite to refine image details while preserving subject features and overall structure, with good color retention in the author's visual tests. V1 provides the best clarity and detail enhancement among these releases in the author's comparisons, making it the author's personal choice for overall quality.
Use it for refinement after upscaling and image restoration guided by an existing image. Generated details are plausible reconstructions, not guaranteed recovery of the original information.
GitHub: ComfyUI-MOSS-LLLite custom nodes
If you would like to support this project: Ko-fi.
Which version should I use?
| Version | Best use | Observed behavior | Relative sampling speed | Setup |
|---|---|---|---|---|
| V1 | Recommended for detail refinement and restoration | Best clarity and detail enhancement in the author's comparisons, with subject-feature preservation and good color retention | Between beta2 and beta3 in the author's workflows | MOSS-LLLite custom nodes; MOSS-Image-SFT |
| beta2 β LoRA | High control strength and minimal changes | Strongest preservation of original features; changes the image least. Preserves existing detail rather than repairing it | Slowest | Built-in control node and LoRA loader; MOSS-Image-Base |
| beta3 β residual adapter | Speed first | Strong structural control, but tends to smooth away high-frequency detail; currently not generally recommended | Fastest | Legacy residual nodes included in this package; MOSS-Image-SFT |
These comparisons reflect the author's visual evaluation and workflows, not a standardized benchmark. The versions use different control paths and Base/SFT families; the same numeric strength does not imply the same control intensity.
Downloads
| File | Load with |
|---|---|
| V1/MOSS-LLLite-Tile-V1.safetensors | Load MOSS-LLLite |
| beta2/epoch1/adapter_model.safetensors | Load LoRA (Model Only) |
| beta3/epoch1/adapter_model.safetensors | Load MOSS Tile Control |
| beta3/epoch2/adapter_model.safetensors | Load MOSS Tile Control |
| ComfyUI-MOSS-LLLite.zip | Custom node installation archive |
The beta2 and beta3 files are retained unchanged for existing users. V1 is the final design established through four iterations of the control approach.
V1: installation and usage
Use a recent ComfyUI with native MOSS-Image, Anima LLLite, and the V3 node API. No extra Python packages are required by these custom nodes.
- Extract ComfyUI-MOSS-LLLite.zip into
ComfyUI/custom_nodes/, producingcustom_nodes/ComfyUI-MOSS-LLLite/. Alternatively, copy the included ComfyUI-MOSS-LLLite directory there, or install from GitHub. - If the old
ComfyUI-Moss-Tile-Controlcustom node directory is installed, remove it before installing this package to avoid duplicate node IDs. The updated package includes the beta3 nodes and preserves existing workflow IDs. - Place
MOSS-LLLite-Tile-V1.safetensorsinComfyUI/models/model_patches/. - Restart ComfyUI. Add Load MOSS-LLLite and Apply MOSS-LLLite from the MOSS-LLLite category.
- Select V1 in the loader. Connect the MOSS-Image-SFT
MODEL, controller, and referenceIMAGEto the apply node. Connect its outputMODELto the sampler. - Keep normal text conditioning and VAE connections. The apply node accepts RGB images directly and has no VAE input. Resize the reference image to the intended output dimensions before applying control.
| Parameter | Suggested starting point |
|---|---|
strength |
0.5β1.0; adjust for the desired preservation/refinement balance |
start_percent |
0.0 |
end_percent |
1.0 |
Strength is continuously adjustable. Higher values generally increase the image's
influence, but visual changes need not be linear or strictly monotonic. At
strength = 0, the apply node returns the input model directly, without encoding
the control image or adding control patches. Other LoRAs already applied to the
input model remain active.
Load MOSS-LLLite and Apply MOSS-LLLite were previously displayed with a
Tile suffix. Their internal IDs are unchanged. The nodes are not task-locked to
Tile, but other control tasks require appropriately trained MOSS-LLLite weights;
V1 itself is a Tile checkpoint.
beta2: maximum preservation
Choose beta2 when high control strength and minimal modification matter more than detail repair. In the author's tests, it preserves original features most strongly and changes the image least, but does not repair fine details. Its behavior is closer to a conservative upscaler: strong input preservation leaves less room for generative detail refinement. It is also the slowest option in the tested workflows.
- Put beta2 weights in
ComfyUI/models/loras/and use Load LoRA (Model Only). - Use the built-in MOSS-Image Color/Depth Control node. Connect the actual
reference image to
color_map, leavedepth_mapempty, and use the Flux2 VAE. No color-region or depth preprocessing is needed for this Tile adapter. - Route both positive and negative conditioning through that node to the sampler. Use MOSS-Image-Base and match the reference and output dimensions.
No additional custom nodes are needed. Control-image strength and LoRA strength are separate: setting control strength to zero does not remove the LoRA's effect on the backbone. Bypass both for a fully disabled beta2 comparison.
beta3: speed first, legacy option
beta3 is the fastest option in the author's workflows and provides strong structural control. It tends to smooth high-frequency textures and fine details, so V1 is recommended for general restoration.
Put beta3 weights in ComfyUI/models/model_patches/. Use Load MOSS Tile Control
and Apply MOSS Tile Control, included in the current package. Connect the
MOSS-Image-SFT MODEL, controller, Flux2 VAE, and reference IMAGE. At strength
zero, control is bypassed. beta3 weights cannot be loaded with the LLLite nodes.
V1 examples and comparisons
These four examples use the released V1 weights. The left column is the workflow's upscaled control image, aligned to the output dimensions; the right column is the actual V1 output. Color Match and sharpening were not applied. Images below link to their full-resolution files.
| Example | Input control | V1 output | Workflow |
|---|---|---|---|
| Flying cat | ![]() |
![]() |
JSON |
| Grass photograph | ![]() |
![]() |
JSON |
| Jetpack cat | ![]() |
![]() |
JSON |
| Cat photograph | ![]() |
![]() |
JSON |
Each output PNG also embeds its cleaned ComfyUI workflow: drag it into ComfyUI
to load the graph. Copy the matching *-input.png from examples/v1
into ComfyUI/input/, install V1, then select your installed backbone, text
encoder, VAE, and acceleration LoRA in the loaders. The separate *.workflow.json
files are UI workflows; *.api.json files are API prompts.
The recorded setup uses MOSS-Image-SFT INT8/ConvRot, the Qwen3.5-9B BF16
text encoder, Flux2 VAE, and Coffmeteor-sft-15step-cfg3 acceleration LoRA
at strength 1.0. Sampling: 15 steps, CFG 5, Euler / SGM uniform, denoise 1,
shift 3, seed 994529790995974. V1 strength is 1.0, active from 0 to 1.
The acceleration LoRA is separate from V1 and is not included in this repository.
The flying-cat and jetpack-cat inputs are enlarged 4Γ with Lanczos. The two photographs are deliberately reduced to 10% and then enlarged 5Γ to test restoration; their original high-resolution sources are included for reproducing that preprocessing. Small border adjustments follow the model's 16-pixel grid. These are prompt-guided restoration examples, not a standardized benchmark or proof that all generated details match the original scene.
See example instructions and exact settings for the files and preprocessing.
Legacy beta2/beta3 examples and workflows
The following examples are legacy beta2/beta3 comparisons, not V1 results. Each comparison shows the input on the left and output on the right.
Existing workflows are retained for beta2 and beta3. Follow the V1 instructions above or load one of the V1 example workflows; the old graphs use different load/apply nodes.
Compatibility and limitations
- V1 uses MOSS-Image-SFT. MOSS-Edit reference-image and cached-reference-KV paths are currently unsupported by the LLLite nodes.
- V1, beta3, beta2, and Anima LLLite weight files are not interchangeable. Remove old beta2 concat Tile LoRAs when switching to V1 or beta3.
- V1 retains colors well in the author's comparisons, but color, contrast, or saturation shifts can still occur. Color Match can optionally correct the output using the original image as the color reference.
- Fine detail may be invented or changed. Evaluate results when exact identity, text, patterns, or faithful document reconstruction matters.
- The prompt, base model, sampling settings, quantization, and other LoRAs affect results. Compare versions with the same image and controlled settings where possible; higher strength is not automatically better.
Development notes and credits
See RESEARCH_REPORT.md for a concise development report in English, including the architectural choices, color investigation, and checkpoint selection. SHA256SUMS.txt records hashes of the distributed weights and node ZIP.
Built on MOSS-Image, ComfyUI, and ComfyUI's native Anima LLLite modules. This is a community-developed control adapter. Inference code attribution and GPL-3.0 terms are included in NOTICE and LICENSE; model weights have their own applicable terms.
- Downloads last month
- 217
Model tree for Xabsurd/MOSS-Image-Tile-Control
Base model
OpenMOSS-Team/MOSS-Image-Base










