# huggingface/transformers.js-examples architecture

> Architecture diagram of the GitHub repository huggingface/transformers.js-examples, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/huggingface/transformers.js-examples
- Repository: https://github.com/huggingface/transformers.js-examples

## Overview

This repository is a collection of independent Transformers.js examples, not one application with a shared runtime. The typical browser demo lets a user provide text, an image, or audio, runs an inference task in a worker or app, and presents the result; the Node.js and framework examples demonstrate other ways to host inference. The map groups the major documented capabilities and notable example families. Many implementations were not sampled, so uncertain internal links are omitted rather than inferred from filenames.

Main entry points: [`llama-3.2-webgpu/src`](https://github.com/huggingface/transformers.js-examples/tree/main/llama-3.2-webgpu/src) (LLM chats), [`deepseek-r1-webgpu/src`](https://github.com/huggingface/transformers.js-examples/tree/main/deepseek-r1-webgpu/src) (Reasoning chats), [`janus-webgpu/src`](https://github.com/huggingface/transformers.js-examples/tree/main/janus-webgpu/src) (Vision chats), [`smolvlm-webgpu/src`](https://github.com/huggingface/transformers.js-examples/tree/main/smolvlm-webgpu/src) (SmolVLM chat)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_chat["Chat and multimodal"]
  node_llm["LLM chats<br/>[src]"]
  node_reasoning["Reasoning chats"]
  node_visionchat["Vision chats"]
  node_smolvlm["SmolVLM chat"]
  node_voxtral["Voxtral transcription"]
end

subgraph group_tasks["Browser task demos"]
  node_speech["Speech demos"]
  node_translation["Translation"]
  node_vision["Vision tasks"]
  node_segmentation["Segmentation"]
  node_background["Background removal"]
  node_video["Video inference"]
  node_retrieval["Adaptive retrieval"]
  node_completion["Code completion"]
  node_attention["Attention visualization"]
  node_tokenizer["Tokenizer playground"]
end

subgraph group_runtime["Server and runtimes"]
  node_node["Node.js examples"]
  node_bun["Bun embeddings"]
  node_deno["Deno embeddings"]
  node_next["Next.js sentiment"]
  node_svelte["SvelteKit sentiment"]
end

subgraph group_search["Search and embeddings"]
  node_semanticsearch["PGlite semantic search"]
  node_image_search["Image search"]
  node_audio_search["Audio search"]
  node_embedding["Embedding demos"]
end

node_user(("Demo user"))

node_user -->|"uses demo"| node_llm
node_user -->|"uses demo"| node_reasoning
node_user -->|"uses demo"| node_visionchat
node_user -->|"uses demo"| node_smolvlm
node_user -.->|"uses demo"| node_voxtral
node_user -.->|"uses demo"| node_speech
node_user -.->|"uses demo"| node_translation
node_user -.->|"uses demo"| node_vision
node_user -->|"uses demo"| node_segmentation
node_user -->|"uses demo"| node_background
node_user -.->|"uses demo"| node_video
node_user -.->|"uses demo"| node_retrieval
node_user -.->|"uses demo"| node_completion
node_user -.->|"uses demo"| node_attention
node_user -.->|"uses demo"| node_tokenizer
node_user -->|"uses demo"| node_semanticsearch
node_user -.->|"uses demo"| node_image_search
node_user -.->|"uses demo"| node_audio_search
node_user -.->|"uses demo"| node_embedding
node_user -->|"uses example"| node_node
node_user -->|"uses example"| node_bun
node_user -->|"uses example"| node_deno
node_user -->|"uses example"| node_next
node_user -->|"uses example"| node_svelte

click node_llm "https://github.com/huggingface/transformers.js-examples/tree/main/llama-3.2-webgpu/src"
click node_reasoning "https://github.com/huggingface/transformers.js-examples/tree/main/deepseek-r1-webgpu/src"
click node_visionchat "https://github.com/huggingface/transformers.js-examples/tree/main/janus-webgpu/src"
click node_smolvlm "https://github.com/huggingface/transformers.js-examples/tree/main/smolvlm-webgpu/src"
click node_voxtral "https://github.com/huggingface/transformers.js-examples/tree/main/voxtral-webgpu/src"
click node_speech "https://github.com/huggingface/transformers.js-examples/tree/main/realtime-whisper-webgpu/src"
click node_translation "https://github.com/huggingface/transformers.js-examples/tree/main/react-translator/src"
click node_vision "https://github.com/huggingface/transformers.js-examples/tree/main/florence2-webgpu/src"
click node_segmentation "https://github.com/huggingface/transformers.js-examples/tree/main/segment-anything-webgpu"
click node_background "https://github.com/huggingface/transformers.js-examples/tree/main/remove-background-webgpu/src"
click node_video "https://github.com/huggingface/transformers.js-examples/tree/main/video-object-detection"
click node_retrieval "https://github.com/huggingface/transformers.js-examples/tree/main/adaptive-retrieval/src"
click node_completion "https://github.com/huggingface/transformers.js-examples/tree/main/code-completion/src"
click node_attention "https://github.com/huggingface/transformers.js-examples/tree/main/attention-visualization/src"
click node_tokenizer "https://github.com/huggingface/transformers.js-examples/tree/main/the-tokenizer-playground/src"
click node_semanticsearch "https://github.com/huggingface/transformers.js-examples/tree/main/pglite-semantic-search/src"
click node_image_search "https://github.com/huggingface/transformers.js-examples/tree/main/semantic-image-search-web/src"
click node_audio_search "https://github.com/huggingface/transformers.js-examples/tree/main/semantic-audio-search"
click node_embedding "https://github.com/huggingface/transformers.js-examples/tree/main/webgpu-nomic-embed"
click node_node "https://github.com/huggingface/transformers.js-examples/tree/main/node-esm"
click node_bun "https://github.com/huggingface/transformers.js-examples/tree/main/bun"
click node_deno "https://github.com/huggingface/transformers.js-examples/tree/main/deno-embed"
click node_next "https://github.com/huggingface/transformers.js-examples/tree/main/next-server"
click node_svelte "https://github.com/huggingface/transformers.js-examples/tree/main/sveltekit"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_llm,node_reasoning,node_visionchat,node_smolvlm,node_voxtral,node_user toneBlue
class node_speech,node_translation,node_vision,node_segmentation,node_background,node_video,node_retrieval,node_completion,node_attention,node_tokenizer toneAmber
class node_node,node_bun,node_deno,node_next,node_svelte toneMint
class node_semanticsearch,node_image_search,node_audio_search,node_embedding toneRose
```

## Components

### Chat and multimodal

- [LLM chats](https://github.com/huggingface/transformers.js-examples/tree/main/llama-3.2-webgpu/src): `llama-3.2-webgpu/src`
- [Reasoning chats](https://github.com/huggingface/transformers.js-examples/tree/main/deepseek-r1-webgpu/src): `deepseek-r1-webgpu/src`
- [Vision chats](https://github.com/huggingface/transformers.js-examples/tree/main/janus-webgpu/src): `janus-webgpu/src`
- [SmolVLM chat](https://github.com/huggingface/transformers.js-examples/tree/main/smolvlm-webgpu/src): `smolvlm-webgpu/src`
- [Voxtral transcription](https://github.com/huggingface/transformers.js-examples/tree/main/voxtral-webgpu/src): `voxtral-webgpu/src`

### Browser task demos

- [Speech demos](https://github.com/huggingface/transformers.js-examples/tree/main/realtime-whisper-webgpu/src): `realtime-whisper-webgpu/src`
- [Translation](https://github.com/huggingface/transformers.js-examples/tree/main/react-translator/src): `react-translator/src`
- [Vision tasks](https://github.com/huggingface/transformers.js-examples/tree/main/florence2-webgpu/src): `florence2-webgpu/src`
- [Segmentation](https://github.com/huggingface/transformers.js-examples/tree/main/segment-anything-webgpu): `segment-anything-webgpu`
- [Background removal](https://github.com/huggingface/transformers.js-examples/tree/main/remove-background-webgpu/src): `remove-background-webgpu/src`
- [Video inference](https://github.com/huggingface/transformers.js-examples/tree/main/video-object-detection): `video-object-detection`
- [Adaptive retrieval](https://github.com/huggingface/transformers.js-examples/tree/main/adaptive-retrieval/src): `adaptive-retrieval/src`
- [Code completion](https://github.com/huggingface/transformers.js-examples/tree/main/code-completion/src): `code-completion/src`
- [Attention visualization](https://github.com/huggingface/transformers.js-examples/tree/main/attention-visualization/src): `attention-visualization/src`
- [Tokenizer playground](https://github.com/huggingface/transformers.js-examples/tree/main/the-tokenizer-playground/src): `the-tokenizer-playground/src`

### Server and runtimes

- [Node.js examples](https://github.com/huggingface/transformers.js-examples/tree/main/node-esm): `node-esm`
- [Bun embeddings](https://github.com/huggingface/transformers.js-examples/tree/main/bun): `bun`
- [Deno embeddings](https://github.com/huggingface/transformers.js-examples/tree/main/deno-embed): `deno-embed`
- [Next.js sentiment](https://github.com/huggingface/transformers.js-examples/tree/main/next-server): `next-server`
- [SvelteKit sentiment](https://github.com/huggingface/transformers.js-examples/tree/main/sveltekit): `sveltekit`

### Search and embeddings

- [PGlite semantic search](https://github.com/huggingface/transformers.js-examples/tree/main/pglite-semantic-search/src): `pglite-semantic-search/src`
- [Image search](https://github.com/huggingface/transformers.js-examples/tree/main/semantic-image-search-web/src): `semantic-image-search-web/src`
- [Audio search](https://github.com/huggingface/transformers.js-examples/tree/main/semantic-audio-search): `semantic-audio-search`
- [Embedding demos](https://github.com/huggingface/transformers.js-examples/tree/main/webgpu-nomic-embed): `webgpu-nomic-embed`

### Other components

- **Demo user**

## Connections

- Demo user → LLM chats: uses demo (evidence: `README.md`)
- Demo user → Reasoning chats: uses demo (evidence: `README.md`)
- Demo user → Vision chats: uses demo (evidence: `README.md`)
- Demo user → SmolVLM chat: uses demo (evidence: `README.md`)
- Demo user → Voxtral transcription: uses demo
- Demo user → Speech demos: uses demo
- Demo user → Translation: uses demo
- Demo user → Vision tasks: uses demo
- Demo user → Segmentation: uses demo (evidence: `README.md`)
- Demo user → Background removal: uses demo (evidence: `README.md`)
- Demo user → Video inference: uses demo
- Demo user → Adaptive retrieval: uses demo
- Demo user → Code completion: uses demo
- Demo user → Attention visualization: uses demo
- Demo user → Tokenizer playground: uses demo
- Demo user → PGlite semantic search: uses demo (evidence: `README.md`)
- Demo user → Image search: uses demo
- Demo user → Audio search: uses demo
- Demo user → Embedding demos: uses demo
- Demo user → Node.js examples: uses example (evidence: `README.md`)
- Demo user → Bun embeddings: uses example (evidence: `README.md`)
- Demo user → Deno embeddings: uses example (evidence: `README.md`)
- Demo user → Next.js sentiment: uses example (evidence: `README.md`)
- Demo user → SvelteKit sentiment: uses example (evidence: `README.md`)
