Files
LocalAI/docs/static/images/diagrams/diarization-pipeline.html
LocalAI [bot] 7e59a5c7c5 docs: architecture & feature diagrams (blueprint style) (#10137)
* docs: add 'how LocalAI works' architecture diagram

Add a blueprint-style architecture diagram: clients -> small core (API,
router, WebUI, agents) -> gRPC -> backend processes pulled on demand as
OCI images. Place it on the overview page and replace the stale external
architecture image on the reference page.

Assisted-by: Claude:claude-opus-4-8 [Claude Code]
Signed-off-by: Ettore Di Giacinto <mudler@localai.io>

* docs: add blueprint diagrams across feature, distributed & getting-started docs

Add 24 architecture/flow/comparison diagrams (PNG + HTML source) under
docs/static/images/diagrams/, wired into their docs pages, from an
impact-vs-effort audit of the docs. Broaden the API surface on the
overview architecture diagram (OpenAI, Anthropic, ElevenLabs, Ollama,
and LocalAI's own API) and move the gRPC boundary label clear of the arrows.

Pages: distributed mode (architecture, scheduling, ds4 layer-split),
distributed inferencing, MLX, realtime, quantization, MCP, agents,
mitm & cloud proxy, middleware, reverse-proxy TLS, VRAM, voice & face
recognition, reranker, function calling, fine-tuning (recipe + jobs),
diarization, audio transform, quickstart, model resolution.

Assisted-by: Claude:claude-opus-4-8 [Claude Code]
Signed-off-by: Ettore Di Giacinto <mudler@localai.io>

* docs: add composable-core diagram to README hero

Commit the composable-core card (small core + on-demand backend tiles)
alongside the other diagrams and reference it from the README hero via a
repo-relative path, so it renders on GitHub.

Assisted-by: Claude:claude-opus-4-8 [Claude Code]
Signed-off-by: Ettore Di Giacinto <mudler@localai.io>

* docs: fix composable-core connectors/badge and federated-vs-worker layout

- composable-core: thicken the plug-in connectors so they read clearly, and
  widen the SEPARATE IMAGE badge so its text no longer overflows the box.
- federated-vs-worker: shorten the WHOLE/SPLIT REQUEST pills to fit, and
  replace the tangled node-to-node activation arrows with a clean fan-out
  (request split across all sharded nodes), mirroring the federated panel.

Assisted-by: Claude:claude-opus-4-8 [Claude Code]
Signed-off-by: Ettore Di Giacinto <mudler@localai.io>

---------

Signed-off-by: Ettore Di Giacinto <mudler@localai.io>
Co-authored-by: Ettore Di Giacinto <mudler@localai.io>
2026-06-02 18:43:22 +02:00

162 lines
7.4 KiB
HTML

<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link href="https://fonts.googleapis.com/css2?family=Bricolage+Grotesque:opsz,wght@12..96,600;12..96,700;12..96,800&family=Archivo:wght@500;600;700&display=swap" rel="stylesheet">
<style>
:root{
--paper:#F3E8D2; --paper2:#ECDFC2; --ink:#211C14; --ink-soft:#5A5142;
--rust:#B43A2C; --rust-deep:#8F2C20; --cold:#3F6E73; --hi:#E7D6AE; --dim:#A99F88;
}
*{box-sizing:border-box;margin:0;padding:0}
html,body{width:1600px;height:900px}
body{
background:var(--paper);color:var(--ink);font-family:"Archivo",sans-serif;
position:relative;overflow:hidden;
background-image:
linear-gradient(var(--paper2) 1px,transparent 1px),
linear-gradient(90deg,var(--paper2) 1px,transparent 1px);
background-size:40px 40px;
}
.frame{position:absolute;inset:26px;border:3px solid var(--ink);}
.wrap{position:absolute;inset:26px;padding:30px 56px 26px;display:flex;flex-direction:column}
header{display:flex;align-items:flex-end;justify-content:space-between;gap:30px}
.eyebrow{font-weight:700;letter-spacing:.22em;text-transform:uppercase;font-size:17px;color:var(--rust-deep)}
.eyebrow b{color:var(--ink)}
h1{font-family:"Bricolage Grotesque",sans-serif;font-weight:800;font-size:50px;line-height:.98;letter-spacing:-.015em;margin-top:6px}
h1 em{font-style:normal;color:var(--rust)}
.stamp{border:3px solid var(--ink);padding:10px 16px 8px;transform:rotate(3deg);text-align:center;background:var(--paper);box-shadow:6px 6px 0 var(--ink);flex:none}
.stamp .k{font-family:"Bricolage Grotesque";font-weight:800;font-size:21px;letter-spacing:.04em;line-height:1.05}
.stamp .s{font-weight:700;font-size:11px;letter-spacing:.18em;text-transform:uppercase;color:var(--ink-soft);margin-top:5px}
.stage{flex:1;margin-top:8px}
svg{width:100%;height:100%;overflow:visible}
footer{display:flex;align-items:center;justify-content:space-between;margin-top:6px;gap:24px}
.note{font-weight:600;font-size:18px;color:var(--ink-soft);line-height:1.3;max-width:1080px}
.note b{color:var(--ink)}
.url{font-family:"Bricolage Grotesque";font-weight:800;font-size:22px;color:var(--rust-deep);letter-spacing:.01em;flex:none}
.url span{color:var(--ink)}
</style>
</head>
<body>
<div class="frame"></div>
<div class="wrap">
<header>
<div>
<div class="eyebrow">LocalAI <b>&middot;</b> Diarization</div>
<h1>Who spoke <em>when</em></h1>
</div>
<div class="stamp">
<div class="k">RTTM</div>
<div class="s">out</div>
</div>
</header>
<div class="stage"><svg viewBox="0 0 1480 560" id="svg"></svg></div>
<footer>
<div class="note">Segment, embed, and cluster <b>-</b> or a single ASR pass <b>-</b> into speaker-labelled segments.</div>
<div class="url">localai.io<span>/features/audio-diarization</span></div>
</footer>
</div>
<script>
const INK="#211C14", PAPER="#F3E8D2", PAPER2="#ECDFC2", HI="#E7D6AE", SOFT="#5A5142", RUST="#B43A2C", RUSTD="#8F2C20", COLD="#3F6E73", DIM="#A99F88";
function el(t,a,x){const e=document.createElementNS("http://www.w3.org/2000/svg",t);for(const k in a)e.setAttribute(k,a[k]);if(x!=null)e.textContent=x;return e;}
const svg=document.getElementById("svg");
function shadowRect(x,y,w,h,fill,stroke,sw,dash){
svg.appendChild(el("rect",{x:x+7,y:y+7,width:w,height:h,fill:INK}));
svg.appendChild(el("rect",{x,y,width:w,height:h,fill,stroke:stroke||INK,"stroke-width":sw||3.5,"stroke-dasharray":dash||"none"}));
}
function txt(x,y,s,o){o=o||{};svg.appendChild(el("text",{x,y,"font-family":o.f||"Archivo","font-weight":o.w||700,"font-size":o.sz||15,"letter-spacing":o.ls||"0","text-anchor":o.a||"start",fill:o.fill||INK},s));}
function arrow(x1,y1,x2,y2,color,dash){
const mx=(x1+x2)/2;
svg.appendChild(el("path",{d:`M ${x1} ${y1} C ${mx} ${y1}, ${mx} ${y2}, ${x2-11} ${y2}`,fill:"none",stroke:color,"stroke-width":3.5,"stroke-linecap":"round","stroke-dasharray":dash||"none"}));
const a=7;
svg.appendChild(el("path",{d:`M ${x2-11} ${y2} l -${a+4} -${a} M ${x2-11} ${y2} l -${a+4} ${a}`,fill:"none",stroke:color,"stroke-width":3.5,"stroke-linecap":"round"}));
}
// ============ INPUT: audio -> ffmpeg ============
// audio
shadowRect(20,238,150,84,PAPER2);
txt(95,278,"audio",{f:"Bricolage Grotesque",w:800,sz:24,a:"middle"});
txt(95,302,"wav · mp3 · m4a",{w:700,sz:12,a:"middle",fill:SOFT});
// ffmpeg
shadowRect(212,238,178,84,HI);
txt(301,275,"ffmpeg",{f:"Bricolage Grotesque",w:800,sz:24,a:"middle"});
txt(301,300,"16 kHz · mono",{w:700,sz:13,a:"middle",fill:SOFT});
arrow(170,280,212,280,INK);
// ============ PATH LABELS ============
const PAX=470, PAW=560; // path A column band x range
// Path A header band
svg.appendChild(el("line",{x1:455,y1:96,x2:1100,y2:96,stroke:RUSTD,"stroke-width":2.5,"stroke-dasharray":"3 7"}));
txt(462,86,"PATH A",{w:700,sz:13,ls:".2em",fill:RUSTD});
txt(548,86,"sherpa-onnx · segment + embed + cluster",{w:700,sz:14,fill:SOFT});
svg.appendChild(el("line",{x1:455,y1:476,x2:1100,y2:476,stroke:COLD,"stroke-width":2.5,"stroke-dasharray":"3 7"}));
txt(462,498,"PATH B",{w:700,sz:13,ls:".2em",fill:COLD});
txt(548,498,"vibevoice · single ASR pass",{w:700,sz:14,fill:SOFT});
// ============ PATH A (top, rust) ============
// four boxes in a row
const aBoxW=148, aBoxH=92, aY=120;
const aXs=[470,640,810,980];
const aBoxes=[
{n:"segment", s:"VAD windows"},
{n:"embed", s:"speaker vec"},
{n:"cluster", s:"group by ID"},
{n:"labelled", s:"segments"},
];
aBoxes.forEach((b,i)=>{
const x=aXs[i];
shadowRect(x,aY,aBoxW,aBoxH,"#EFE0BF",RUST,3.5);
txt(x+aBoxW/2,aY+44,b.n,{f:"Bricolage Grotesque",w:800,sz:22,a:"middle",fill:INK});
txt(x+aBoxW/2,aY+68,b.s,{w:700,sz:13,a:"middle",fill:SOFT});
});
// arrows between A boxes
for(let i=0;i<aXs.length-1;i++){
arrow(aXs[i]+aBoxW, aY+aBoxH/2, aXs[i+1], aY+aBoxH/2, RUST);
}
// ============ PATH B (bottom, cold) ============
const bBoxW=232, bBoxH=92, bY=372;
const bXs=[520,820];
const bBoxes=[
{n:"single ASR pass", s:"transcribe + tag speakers"},
{n:"segments + transcript", s:"text per speaker turn"},
];
bBoxes.forEach((b,i)=>{
const x=bXs[i];
shadowRect(x,bY,bBoxW,bBoxH,PAPER,COLD,3.5);
txt(x+bBoxW/2,bY+44,b.n,{f:"Bricolage Grotesque",w:800,sz:21,a:"middle",fill:INK});
txt(x+bBoxW/2,bY+70,b.s,{w:700,sz:13,a:"middle",fill:COLD});
});
arrow(bXs[0]+bBoxW, bY+bBoxH/2, bXs[1], bY+bBoxH/2, COLD);
// ============ ffmpeg -> branch into A and B ============
// to Path A first box
arrow(390,266,aXs[0],aY+aBoxH/2,RUST,"2 8");
// to Path B first box
arrow(390,294,bXs[0],bY+bBoxH/2,COLD,"2 8");
// ============ OUTPUT (right) ============
const oX=1170, oW=270, oY=216, oH=128;
shadowRect(oX,oY,oW,oH,PAPER,INK,4);
svg.appendChild(el("rect",{x:oX,y:oY,width:oW,height:50,fill:RUST}));
svg.appendChild(el("line",{x1:oX,y1:oY+50,x2:oX+oW,y2:oY+50,stroke:INK,"stroke-width":4}));
txt(oX+oW/2,oY+33,"output",{f:"Bricolage Grotesque",w:800,sz:24,a:"middle",fill:PAPER});
const fmts=["json","verbose_json","rttm"];
fmts.forEach((f,i)=>{
const fy=oY+66+i*20;
txt(oX+24,fy+7,"·",{w:800,sz:18,fill:RUSTD});
txt(oX+40,fy+7,f,{f:"Bricolage Grotesque",w:700,sz:18,fill:INK});
});
// ============ converge A and B -> output ============
arrow(aXs[3]+aBoxW, aY+aBoxH/2, oX, oY+oH*0.42, RUST);
arrow(bXs[1]+bBoxW, bY+bBoxH/2, oX, oY+oH*0.74, COLD);
</script>
</body>
</html>