102 lines
8.1 KiB
HTML
102 lines
8.1 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="utf-8">
|
|
<meta name="viewport" content="width=device-width, initial-scale=1">
|
|
<title>ComfyUI-HiCache — Training-free Hunyuan3D shape-generation acceleration for ComfyUI</title>
|
|
<meta name="description" content="One ComfyUI node, HiCache Accelerate (Hunyuan3D), wired between Hy3DModelLoader and the mesh sampler. On compute steps the shape DiT runs normally and its output is cached; on skipped steps the DiT is not called and the flow-matching velocity is forecast from the cached anchors."
|
|
<meta property="og:title" content="ComfyUI-HiCache — Training-free Hunyuan3D shape-generation acceleration for ComfyUI">
|
|
<meta property="og:description" content="One ComfyUI node, HiCache Accelerate (Hunyuan3D), wired between Hy3DModelLoader and the mesh sampler. On compute steps the shape DiT runs normally and its output is cached; on skipped steps the DiT is">
|
|
<meta property="og:type" content="website">
|
|
<meta property="og:url" content="https://archerkattri.github.io/ComfyUI-HiCache/">>
|
|
<style>
|
|
:root{
|
|
--bg:#ffffff; --ink:#17202a; --muted:#5a6572; --line:#e3e8ee;
|
|
--accent:#0c52d6; --accent-ink:#0c52d6; --code-bg:#f4f6f8; --mono:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;
|
|
}
|
|
*{box-sizing:border-box}
|
|
html{-webkit-text-size-adjust:100%}
|
|
body{margin:0;background:var(--bg);color:var(--ink);
|
|
font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,sans-serif;
|
|
font-size:16px;line-height:1.6}
|
|
.wrap{max-width:860px;margin:0 auto;padding:0 22px}
|
|
a{color:var(--accent);text-decoration:none}
|
|
a:hover{text-decoration:underline}
|
|
/* top bar */
|
|
.top{border-bottom:1px solid var(--line)}
|
|
.top .wrap{display:flex;align-items:baseline;gap:14px;padding-top:14px;padding-bottom:14px;flex-wrap:wrap}
|
|
.top .repo{font-weight:700;font-size:17px;color:var(--ink)}
|
|
.top .repo a{color:var(--ink)}
|
|
.top .ver{font-family:var(--mono);font-size:12px;color:var(--muted);border:1px solid var(--line);padding:1px 8px;border-radius:20px}
|
|
.top nav{margin-left:auto;display:flex;gap:16px;font-size:14px}
|
|
/* hero */
|
|
.hero{padding:34px 0 8px}
|
|
.hero img.banner{width:100%;height:auto;border:1px solid var(--line);display:block}
|
|
.hero h1{font-size:30px;line-height:1.25;margin:22px 0 6px;letter-spacing:-0.01em}
|
|
.hero p.lede{color:var(--muted);margin:0 0 14px;max-width:62ch}
|
|
pre{background:var(--code-bg);border:1px solid var(--line);padding:12px 14px;overflow-x:auto;
|
|
font-family:var(--mono);font-size:13px;line-height:1.55;margin:0 0 8px}
|
|
pre .c{color:#6a737d}
|
|
/* sections */
|
|
section{padding:26px 0 6px;border-top:1px solid var(--line);margin-top:26px}
|
|
section:first-of-type{border-top:0}
|
|
.sec-head{display:flex;align-items:baseline;gap:12px;margin-bottom:12px}
|
|
.sec-num{font-family:var(--mono);font-size:13px;color:var(--accent-ink);font-weight:700}
|
|
.sec-head h2{font-size:20px;margin:0}
|
|
table.ev{width:100%;border-collapse:collapse;font-size:14px}
|
|
table.ev th,table.ev td{text-align:left;padding:8px 10px;border-bottom:1px solid var(--line);vertical-align:top}
|
|
table.ev th{color:var(--muted);font-weight:600;width:34%}
|
|
table.ev td b{font-variant-numeric:tabular-nums}
|
|
.ok{color:#0a7b3c;font-weight:700}
|
|
.gallery{display:grid;grid-template-columns:1fr 1fr;gap:14px}
|
|
.gallery figure{margin:0;border:1px solid var(--line)}
|
|
.gallery img,.gallery video{width:100%;height:auto;display:block}
|
|
.gallery figcaption{font-size:13px;color:var(--muted);padding:8px 10px;border-top:1px solid var(--line)}
|
|
.limits{background:#fbfcfd;border:1px solid var(--line);padding:14px 16px;font-size:14px}
|
|
.limits ul{margin:8px 0 0;padding-left:20px}
|
|
.limits li{margin:4px 0}
|
|
footer{border-top:1px solid var(--line);margin-top:30px;padding:16px 0 30px;color:var(--muted);font-size:13px}
|
|
footer .wrap{display:flex;gap:16px;flex-wrap:wrap}
|
|
@media (max-width:640px){.gallery{grid-template-columns:1fr}.hero h1{font-size:24px}}
|
|
</style>
|
|
</head>
|
|
<body>
|
|
<header class="top"><div class="wrap">
|
|
<span class="repo"><a href="https://github.com/Archerkattri/ComfyUI-HiCache">ComfyUI-HiCache</a></span>
|
|
<span class="ver">0.2.4</span>
|
|
<nav><a href="https://github.com/Archerkattri/ComfyUI-HiCache">Code</a><a href="https://github.com/Archerkattri/ComfyUI-HiCache/releases/tag/v0.2.4">Release</a> <a href="https://registry.comfy.org/publishers/archerkattri/nodes/comfyui-hicache">Comfy Registry</a></nav>
|
|
</div></header>
|
|
<main class="wrap">
|
|
<div class="hero">
|
|
<img class="banner" src="assets/icon.png" alt="ComfyUI-HiCache banner">
|
|
<h1>Skip Hunyuan3D DiT steps by forecasting flow-matching velocity</h1>
|
|
<p class="lede">One ComfyUI node, HiCache Accelerate (Hunyuan3D), wired between Hy3DModelLoader and the mesh sampler. On compute steps the shape DiT runs normally and its output is cached; on skipped steps the DiT is not called and the flow-matching velocity is forecast from the cached anchors.</p>
|
|
<pre>cd ComfyUI/custom_nodes
|
|
git clone https://github.com/Archerkattri/ComfyUI-HiCache
|
|
pip install -r ComfyUI-HiCache/requirements.txt <span class="c"># just: hicache-pp</span></pre>
|
|
</div>
|
|
<section><div class="sec-head"><span class="sec-num">01</span><h2>Evidence</h2></div>
|
|
<table class="ev"><tr><th>Sampling speedup, hermite interval=3 (in ComfyUI)</th><td><b>2.68x</b> — 0.70 s vs 1.87 s baseline over 30 steps</td></tr><tr><th>Mesh F1@0.05 vs unaccelerated baseline (hermite i3)</th><td><b>0.825</b>, above the 0.751 different-seed floor</td></tr><tr><th>DiT forwards run, hermite i3 (30 steps)</th><td><b>11/30</b> computed, 19 skipped (dmd i5 runs 7/30)</td></tr><tr><th>DMD interval=5 in ComfyUI (2-mini)</th><td><b>1.69x</b> speedup, F1 0.719 — at the seed-noise floor</td></tr><tr><th>Upstream Hunyuan3D-2.1, DMD interval=5</th><td><b>0.860</b> F-score at 1.79x speedup (baseline 0.911)</td></tr><tr><th>Upstream Hunyuan3D-2-mini, DMD interval=5</th><td><b>0.794</b> — exactly lossless vs baseline, at 1.69 s</td></tr><tr><th>CPU unit tests</th><td><b>45</b> passed, no ComfyUI needed</td></tr></table>
|
|
</section>
|
|
<section><div class="sec-head"><span class="sec-num">02</span><h2>Media</h2></div>
|
|
<div class="gallery"><figure><img src="assets/flow.svg" alt="Runtime path diagram"><figcaption>Runtime path: scheduled compute steps anchor the velocity history; skipped steps are forecast; incompatible schedules fall back to the full model.</figcaption></figure><figure><img src="assets/icon.png" alt="ComfyUI-HiCache icon"><figcaption>Project icon, also used as the README banner.</figcaption></figure></div>
|
|
</section>
|
|
<section><div class="sec-head"><span class="sec-num">03</span><h2>Install & verify</h2></div>
|
|
<pre>pytest <span class="c"># expect 45 passed (CPU-only, no ComfyUI needed)</span></pre>
|
|
</section>
|
|
<section><div class="sec-head"><span class="sec-num">04</span><h2>Limits</h2></div>
|
|
<div class="limits"><p style="margin:0">What this release does <b>not</b> claim (from the release notes):</p><ul><li>In-ComfyUI GPU validation.</li></ul></div>
|
|
</section>
|
|
<section><div class="sec-head"><span class="sec-num">05</span><h2>Family</h2></div>
|
|
<table class="ev">
|
|
<tr><th>Runs on</th><td><a href="https://github.com/comfyanonymous/ComfyUI">ComfyUI</a> + <a href="https://github.com/kijai/ComfyUI-Hunyuan3DWrapper">ComfyUI-Hunyuan3DWrapper</a></td></tr>
|
|
<tr><th>Sibling nodes</th><td><a href="https://archerkattri.github.io/ComfyUI-TRELLIS-HiCache/">ComfyUI-TRELLIS-HiCache</a> · <a href="https://archerkattri.github.io/ComfyUI-TRELLIS2-HiCache/">ComfyUI-TRELLIS2-HiCache</a></td></tr>
|
|
<tr><th>Standalone counterparts</th><td><a href="https://archerkattri.github.io/hunyuan2-plus-plus/">hunyuan2-plus-plus</a> · <a href="https://archerkattri.github.io/hunyuan2.1-plus-plus/">hunyuan2.1-plus-plus</a></td></tr>
|
|
<tr><th>Forecast core</th><td><a href="https://archerkattri.github.io/hicache-plus-plus/">hicache-plus-plus</a> (<a href="https://pypi.org/project/hicache-pp/">PyPI</a>)</td></tr>
|
|
</table>
|
|
</section>
|
|
</main>
|
|
<footer><div class="wrap"><span>MIT · © 2026 Krishi Attri</span><span></span><span style="margin-left:auto"><a href="https://github.com/Archerkattri/ComfyUI-HiCache">ComfyUI-HiCache</a></span></div></footer>
|
|
</body>
|
|
</html>
|