nodes/Archerkattri-ComfyUI-TRELLIS2-HiCache
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

docs: replace interim README visuals

Browse Source
This commit is contained in:
Archerkattri
2026-09-17 23:23:39 -04:00
parent 9a1ccf5547
commit 3aab3efb00
2 changed files with 29 additions and 35 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+6 -5
View File
@@ -20,12 +20,13 @@ Pairs with [visualbruno/ComfyUI-Trellis2](https://github.com/visualbruno/ComfyUI
(the `TRELLIS2PIPELINE` type). The TRELLIS v1 sibling is
[ComfyUI-TRELLIS-HiCache](https://github.com/Archerkattri/ComfyUI-TRELLIS-HiCache).
## Runtime path
![TRELLIS.2 HiCache runtime path](docs/flow.svg)
TRELLIS.2 shape stages keep separate schedule and cache identities. Unsupported texture paths remain outside the accelerated boundary and are reported explicitly.
## What it does
## Architecture at a glance
![ComfyUI-TRELLIS2-HiCache architecture](docs/flow.svg)
The integration keeps TRELLIS.2 shape generation explicit while making the forecasted steps visible in the ComfyUI execution path.
TRELLIS.2 samples each stage with a flow-Euler loop that calls a DiT once (or
twice, under classifier-free guidance) per step. **TRELLIS.2 HiCache Accelerate**
docs/flow.svg
+23 -30
View File
@@ -1,31 +1,24 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 900 198" role="img" aria-labelledby="title desc">
<title id="title">TRELLIS.2 HiCache architecture</title>
<desc id="desc">Training-free TRELLIS.2 acceleration</desc>
<rect width="900" height="198" rx="18" fill="#020617"/>
<text x="28" y="36" fill="#f8fafc" font-family="Inter,Segoe UI,sans-serif" font-size="22" font-weight="700">TRELLIS.2 HiCache</text>
<text x="28" y="62" fill="#94a3b8" font-family="Inter,Segoe UI,sans-serif" font-size="13">Training-free TRELLIS.2 acceleration</text>
<path d="M212 131h22m-8-6 8 6-8 6" fill="none" stroke="#64748b" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
<path d="M432 131h22m-8-6 8 6-8 6" fill="none" stroke="#64748b" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
<path d="M652 131h22m-8-6 8 6-8 6" fill="none" stroke="#64748b" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
<g transform="translate(28 94)">
<rect width="184" height="74" rx="12" fill="#111827" stroke="#a78bfa" stroke-width="1.5"/>
<text x="92" y="31" text-anchor="middle" fill="#f8fafc" font-family="ui-monospace, SFMono-Regular, Menlo, monospace" font-size="12" font-weight="700">IMAGE INPUT</text>
<text x="92" y="53" text-anchor="middle" fill="#94a3b8" font-family="ui-monospace, SFMono-Regular, Menlo, monospace" font-size="10">STAGE 1</text>
</g>
<g transform="translate(248 94)">
<rect width="184" height="74" rx="12" fill="#111827" stroke="#a78bfa" stroke-width="1.5"/>
<text x="92" y="31" text-anchor="middle" fill="#f8fafc" font-family="ui-monospace, SFMono-Regular, Menlo, monospace" font-size="12" font-weight="700">SHAPE / TEXTURE DIT</text>
<text x="92" y="53" text-anchor="middle" fill="#94a3b8" font-family="ui-monospace, SFMono-Regular, Menlo, monospace" font-size="10">STAGE 2</text>
</g>
<g transform="translate(468 94)">
<rect width="184" height="74" rx="12" fill="#111827" stroke="#a78bfa" stroke-width="1.5"/>
<text x="92" y="31" text-anchor="middle" fill="#f8fafc" font-family="ui-monospace, SFMono-Regular, Menlo, monospace" font-size="12" font-weight="700">CACHE FORECAST</text>
<text x="92" y="53" text-anchor="middle" fill="#94a3b8" font-family="ui-monospace, SFMono-Regular, Menlo, monospace" font-size="10">STAGE 3</text>
</g>
<g transform="translate(688 94)">
<rect width="184" height="74" rx="12" fill="#111827" stroke="#a78bfa" stroke-width="1.5"/>
<text x="92" y="31" text-anchor="middle" fill="#f8fafc" font-family="ui-monospace, SFMono-Regular, Menlo, monospace" font-size="12" font-weight="700">3D OUTPUT</text>
<text x="92" y="53" text-anchor="middle" fill="#94a3b8" font-family="ui-monospace, SFMono-Regular, Menlo, monospace" font-size="10">STAGE 4</text>
</g>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 420" role="img" aria-labelledby="title desc">
<title id="title">TRELLIS.2 HiCache stage boundary</title>
<desc id="desc">Acceleration is confined to supported shape stages; optional texture remains explicit and separately reported.</desc>
<rect width="1200" height="420" rx="22" fill="#020617"/>
<defs>
<marker id="arrow" markerWidth="8" markerHeight="8" refX="7" refY="4" orient="auto"><path d="M0 0L8 4L0 8Z" fill="#64748b"/></marker>
<style>.t{font-family:Inter,Segoe UI,sans-serif;fill:#f8fafc}.m{font-family:ui-monospace,SFMono-Regular,Menlo,monospace;fill:#cbd5e1}.muted{fill:#94a3b8}.line{fill:none;stroke:#64748b;stroke-width:2;marker-end:url(#arrow)}.dash{fill:none;stroke:#475569;stroke-width:1.5;stroke-dasharray:6 5}.box{fill:#111827;stroke:#334155;stroke-width:1.5}</style>
</defs>
<text class="t" x="38" y="46" font-size="25" font-weight="700">TRELLIS.2 HiCache stage boundary</text>
<text class="t muted" x="38" y="72" font-size="14">Acceleration is confined to supported shape stages; optional texture remains explicit and separately reported.</text>
<g transform="translate(28 184)"><rect class="box" width="132" height="70" rx="12" stroke="#a78bfa"/><text class="t" x="66" y="30" text-anchor="middle" font-size="14" font-weight="700">Image</text><text class="m muted" x="66" y="53" text-anchor="middle" font-size="11">conditioning</text></g>
<path class="line" d="M160 219L205 219"/>
<g transform="translate(205 145)"><rect class="box" width="220" height="148" rx="12" stroke="#8b5cf6"/><text class="t" x="110" y="69" text-anchor="middle" font-size="14" font-weight="700">Sparse structure</text><text class="m muted" x="110" y="92" text-anchor="middle" font-size="11">own cache + schedule</text></g>
<text class="m" x="315" y="234" text-anchor="middle" font-size="11">compute ↔ forecast ↔ fallback</text>
<path class="line" d="M425 219L475 219"/>
<g transform="translate(475 145)"><rect class="box" width="220" height="148" rx="12" stroke="#8b5cf6"/><text class="t" x="110" y="69" text-anchor="middle" font-size="14" font-weight="700">Shape SLaT</text><text class="m muted" x="110" y="92" text-anchor="middle" font-size="11">own cache + schedule</text></g>
<text class="m" x="585" y="234" text-anchor="middle" font-size="11">compute ↔ forecast ↔ fallback</text>
<path class="line" d="M695 219L745 219"/>
<g transform="translate(745 166)"><rect class="box" width="165" height="106" rx="12" stroke="#38bdf8"/><text class="t" x="82.5" y="48" text-anchor="middle" font-size="14" font-weight="700">Mesh</text><text class="m muted" x="82.5" y="71" text-anchor="middle" font-size="11">shape output</text></g>
<path class="line" d="M910 219L955 219"/>
<g transform="translate(955 145)"><rect class="box" width="210" height="148" rx="12" stroke="#f59e0b"/><text class="t" x="105" y="69" text-anchor="middle" font-size="14" font-weight="700">Optional texture</text><text class="m muted" x="105" y="92" text-anchor="middle" font-size="11">outside cache boundary</text></g>
<path class="dash" d="M205 320H695"/><text class="m" x="450" y="350" text-anchor="middle" font-size="11">identity-bound state; no cross-stage or cross-run reuse</text>
<path class="dash" d="M745 320H1165"/><text class="m" x="955" y="350" text-anchor="middle" font-size="11">shape and texture timing reported separately</text>
</svg>
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 2.7 KiB

After

Width:  |  Height:  |  Size: 3.3 KiB