nodes/Archerkattri-ComfyUI-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-15 22:18:44 -04:00
parent 1ff5da381a
commit 6be05f1b0a
2 changed files with 30 additions and 35 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+6 -5
View File
@@ -24,12 +24,13 @@ DMD/Prony-exponential forecasters).
> repeated runs in one session reset state correctly. Measured details in
> *Validated on* below.
## Runtime path
![ComfyUI-HiCache runtime path](docs/flow.svg)
Scheduled Hunyuan3D model evaluations anchor the velocity history. Forecasted steps reuse that history, while incompatible schedules and failed forecasts return to the full model and report the fallback.
## What it does
## Architecture at a glance
![ComfyUI-HiCache architecture](docs/flow.svg)
The node wraps the Hunyuan3D flow loop at the DiT boundary: scheduled model evaluations anchor the velocity forecast between them.
One node, `HiCache Accelerate (Hunyuan3D)`, wired between
[kijai/ComfyUI-Hunyuan3DWrapper](https://github.com/kijai/ComfyUI-Hunyuan3DWrapper)'s
docs/flow.svg
+24 -30
View File
@@ -1,31 +1,25 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 900 198" role="img" aria-labelledby="title desc">
<title id="title">ComfyUI-HiCache architecture</title>
<desc id="desc">Training-free Hunyuan3D 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">ComfyUI-HiCache</text>
<text x="28" y="62" fill="#94a3b8" font-family="Inter,Segoe UI,sans-serif" font-size="13">Training-free Hunyuan3D 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">COMFYUI 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">SCHEDULED 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">VELOCITY 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">MESH 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 440" role="img" aria-labelledby="title desc">
<title id="title">ComfyUI-HiCache runtime path</title>
<desc id="desc">One wrapper, explicit compute/forecast decisions, full-model fallback, and per-run telemetry.</desc>
<rect width="1200" height="440" 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">ComfyUI-HiCache runtime path</text>
<text class="t muted" x="38" y="72" font-size="14">One wrapper, explicit compute/forecast decisions, full-model fallback, and per-run telemetry.</text>
<g transform="translate(35 165)"><rect class="box" width="180" height="78" rx="12" stroke="#a78bfa"/><text class="t" x="90" y="34" text-anchor="middle" font-size="14" font-weight="700">Hy3DModelLoader</text><text class="m muted" x="90" y="57" text-anchor="middle" font-size="11">model + checkpoint</text></g>
<path class="line" d="M215 204L278 204"/>
<g transform="translate(278 145)"><rect class="box" width="205" height="118" rx="12" stroke="#a78bfa"/><text class="t" x="102.5" y="54" text-anchor="middle" font-size="14" font-weight="700">HiCache Accelerate</text><text class="m muted" x="102.5" y="77" text-anchor="middle" font-size="11">schedule · budget · identity</text></g>
<path class="line" d="M483 204L540 204"/>
<path d="M610 145L680 204L610 263L540 204Z" fill="#172033" stroke="#a78bfa" stroke-width="1.5"/><text class="t" x="610" y="199" text-anchor="middle" font-size="13" font-weight="700">compute?</text><text class="m muted" x="610" y="220" text-anchor="middle" font-size="10">schedule / fallback</text>
<path class="line" d="M680 190L742 135"/>
<g transform="translate(742 98)"><rect class="box" width="190" height="74" rx="12" stroke="#f59e0b"/><text class="t" x="95" y="32" text-anchor="middle" font-size="14" font-weight="700">Original Hunyuan DiT</text><text class="m muted" x="95" y="55" text-anchor="middle" font-size="11">refresh velocity history</text></g>
<path class="line" d="M680 218L742 285"/>
<g transform="translate(742 248)"><rect class="box" width="190" height="74" rx="12" stroke="#22c55e"/><text class="t" x="95" y="32" text-anchor="middle" font-size="14" font-weight="700">Hermite / DMD</text><text class="m muted" x="95" y="55" text-anchor="middle" font-size="11">forecast skipped velocity</text></g>
<path class="line" d="M932 135L1000 190"/>
<path class="line" d="M932 285L1000 220"/>
<g transform="translate(1000 165)"><rect class="box" width="165" height="82" rx="12" stroke="#38bdf8"/><text class="t" x="82.5" y="36" text-anchor="middle" font-size="14" font-weight="700">Mesh sampler</text><text class="m muted" x="82.5" y="59" text-anchor="middle" font-size="11">Euler update</text></g>
<rect x="278" y="342" width="887" height="54" rx="10" fill="#0f172a" stroke="#334155"/><text class="m" x="300" y="374" font-size="12">status: compute steps · forecast steps · fallback reason · backend · checkpoint identity</text>
<path class="dash" d="M380 263V342M835 322V342M1082 247V342"/>
</svg>
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 2.7 KiB

After

Width:  |  Height:  |  Size: 3.5 KiB