diff --git a/misc/intro-video/.gitignore b/misc/intro-video/.gitignore
new file mode 100644
index 00000000..b0062491
--- /dev/null
+++ b/misc/intro-video/.gitignore
@@ -0,0 +1,4 @@
+node_modules/
+package-lock.json
+stills/
+*.mp4
diff --git a/misc/intro-video/README.md b/misc/intro-video/README.md
new file mode 100644
index 00000000..b1812219
--- /dev/null
+++ b/misc/intro-video/README.md
@@ -0,0 +1,55 @@
+# WeKnora intro video
+
+The source for the product intro video (about 1:52, 1920×1080 at 30 fps, English on-screen text, no audio). The whole video is one HTML page, `index.html`, which draws any moment from its timestamp. `render.mjs` steps through the timeline with headless Chromium and pipes the frames into ffmpeg.
+
+## Render
+
+Requires Node 18+, ffmpeg and a Chromium build for Playwright.
+
+```bash
+cd misc/intro-video
+npm install
+npx playwright-core install chromium # skip if CHROME_PATH points at a Chromium build
+npm run render # writes weknora-intro.mp4, takes a few minutes
+```
+
+To check a few moments without rendering the whole video:
+
+```bash
+npm run stills -- 9.5 22 57 81 # PNGs in stills/
+```
+
+To preview in a browser, open `index.html?t=22` for one frame, or `index.html?play` to play from the start (`?play=40` starts at 40 s). Open it from the repository checkout, because the brand icons are loaded from `website-docs/homepage/public/docs/_home/brands/`.
+
+For a README upload under GitHub's 10 MB attachment limit, re-encode:
+
+```bash
+ffmpeg -i weknora-intro.mp4 -c:v libx264 -preset slow -crf 24 -pix_fmt yuv420p -movflags +faststart weknora-intro-lite.mp4
+```
+
+## Structure
+
+| Scene | Time (s) | Content |
+|---|---|---|
+| `open` | 0–6.6 | Scattered sources and files: "Your team's knowledge lives in a hundred places." |
+| `logo` | 6.2–12.2 | Logo and tagline |
+| `pillars` | 11.8–17 | RAG / Agent / Wiki cards |
+| `rag` | 16.6–31 | Chat with retrieval steps, streamed answer, citation popover |
+| `agent` | 30.6–44.4 | Memory, knowledge search, MCP tool call, SLA table |
+| `skill` | 44–60.4 | Toolbox skills, then sandbox terminal and the generated .docx |
+| `browser` | 60–74.6 | BrowserSkill driving Chrome: release lookup and form fill |
+| `wiki` | 74.2–89 | Documents become a wiki tree and page, then a knowledge graph |
+| `eco` | 88.6–100.4 | Data sources, channels and model providers |
+| `outro` | 100–112 | Docker Compose quick start, logo and links |
+
+Scene boundaries are in the `S` object near the bottom of `index.html`. Each scene reads its local time and positions its elements from it, so to retime a scene, edit its offsets inside `render()`. The total length is `DUR`.
+
+The product UI is rebuilt in HTML rather than screenshotted, so the text stays sharp when the camera zooms in. UI labels follow `frontend/src/i18n/locales/en-US.ts`. The conversation content (Nova-KB-POC, the Q3 ticket numbers, the `ticketing.query_issues` MCP tool, the humanoid-robot report) is sample data.
+
+## When to update
+
+- **Version:** the release shown in the browser scene (`v0.8.2`) and the text typed into the form.
+- **Counts:** the model provider count in the ecosystem scene ("27 providers").
+- **Lists:** the data sources and channels, when integrations are added or removed.
+
+`assets/logo-light.png` and `assets/logo-dark.png` are generated from `docs/images/logo.png` by `make-logos.py` (needs Pillow).
diff --git a/misc/intro-video/assets/logo-dark.png b/misc/intro-video/assets/logo-dark.png
new file mode 100644
index 00000000..2dfdfc1a
Binary files /dev/null and b/misc/intro-video/assets/logo-dark.png differ
diff --git a/misc/intro-video/assets/logo-light.png b/misc/intro-video/assets/logo-light.png
new file mode 100644
index 00000000..81aa0d02
Binary files /dev/null and b/misc/intro-video/assets/logo-light.png differ
diff --git a/misc/intro-video/index.html b/misc/intro-video/index.html
new file mode 100644
index 00000000..a067cd48
--- /dev/null
+++ b/misc/intro-video/index.html
@@ -0,0 +1,871 @@
+
+
+
+
+WeKnora Intro
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Find answers. Put knowledge to work.
+
OPEN-SOURCE KNOWLEDGE FRAMEWORK · FROM TENCENT
+
+
+
+
+
+
ONE KNOWLEDGE BASE
+
Three ways to put it to use.
+
+
+
01 · RAG
Answers you can trace
Hybrid retrieval and reranking. Every answer cites its sources.
+
02 · AGENT
Knowledge put to work
Multi-step reasoning with tools, skills, a sandbox and memory.
+
03 · WIKI
Knowledge, organized
Documents become a linked wiki with a knowledge graph.
+
+
Plus skills, a sandbox and your own browser, all working from the same knowledge.
+
+
+
+
+
01 — RAG
Answers you can trace back to the source.
Vector and keyword retrieval run together, get reranked, and every claim links to the passage behind it.
+
+
+
+
+
+
02 — AGENT
Knowledge that gets work done.
The agent plans, searches your knowledge bases, calls MCP tools and remembers what you told it last time.
+
+
+
+
+
+
03 — SKILLS & SANDBOX
It writes the code. You get the file.
Install skills like docx, pptx and pdf. Agents run them in an isolated sandbox with a terminal and desktop.
+
+
+
+
+
+
04 — LOCAL BROWSER
It can drive your own browser, too.
BrowserSkill connects WeKnora to the Chrome you already use. It opens pages, reads, clicks and fills forms, and you can pause or stop it anytime.
+
+
+
+
+
+
05 — WIKI
Documents that organize themselves.
Uploads become a linked wiki of concepts and entities, with a knowledge graph and full revision history.
+
+
+
+
+
+
06 — CONNECTED
Plugs into where your team already works.
+
+
DATA SOURCES
+
CHANNELS & ACCESS
+
KNOWLEDGE · AGENTS · WIKI
+
MODELS
+
+
+
+
+
+
SELF-HOSTED · MIT LICENSED
Runs in your environment.
Swap models, vector databases and storage. Your data stays with you.
+
+
+
+
+
github.com/Tencent/WeKnora|weknora.weixin.qq.com
+
STAR IT · TRY IT · BUILD WITH IT
+
+
+
+
+
+
+
diff --git a/misc/intro-video/make-logos.py b/misc/intro-video/make-logos.py
new file mode 100644
index 00000000..b606aaff
--- /dev/null
+++ b/misc/intro-video/make-logos.py
@@ -0,0 +1,30 @@
+"""Derive the transparent logos in assets/ from docs/images/logo.png.
+
+logo-light.png keeps the original colors for paper backgrounds; logo-dark.png
+turns the navy lettering cream and keeps the gold wave, for navy backgrounds.
+The crop matches the one the homepage uses (x=0, y=208, 945x238).
+"""
+from pathlib import Path
+
+from PIL import Image
+
+here = Path(__file__).resolve().parent
+src = Image.open(here.parents[1] / "docs/images/logo.png").convert("RGB").crop((0, 208, 945, 446))
+w, h = src.size
+light, dark = Image.new("RGBA", (w, h)), Image.new("RGBA", (w, h))
+sp, lp, dp = src.load(), light.load(), dark.load()
+
+for y in range(h):
+ for x in range(w):
+ r, g, b = sp[x, y]
+ a = 255 - min(r, g, b) # coverage against the white ground
+ if a < 4:
+ lp[x, y] = dp[x, y] = (0, 0, 0, 0)
+ continue
+ f = a / 255
+ rr, gg, bb = (int(max(0, min(255, (c - 255 * (1 - f)) / f))) for c in (r, g, b))
+ lp[x, y] = (rr, gg, bb, a)
+ dp[x, y] = (rr, gg, bb, a) if rr > bb + 40 else (246, 241, 232, a)
+
+light.save(here / "assets/logo-light.png")
+dark.save(here / "assets/logo-dark.png")
diff --git a/misc/intro-video/package.json b/misc/intro-video/package.json
new file mode 100644
index 00000000..1e1a65db
--- /dev/null
+++ b/misc/intro-video/package.json
@@ -0,0 +1,13 @@
+{
+ "name": "weknora-intro-video",
+ "private": true,
+ "type": "module",
+ "description": "Source for the WeKnora intro video: an HTML animation rendered frame by frame to MP4.",
+ "scripts": {
+ "render": "node render.mjs video",
+ "stills": "node render.mjs stills"
+ },
+ "dependencies": {
+ "playwright-core": "1.49.1"
+ }
+}
diff --git a/misc/intro-video/render.mjs b/misc/intro-video/render.mjs
new file mode 100644
index 00000000..c14be486
--- /dev/null
+++ b/misc/intro-video/render.mjs
@@ -0,0 +1,52 @@
+// Renders index.html frame by frame into an MP4 (or a few PNG stills).
+//
+// node render.mjs video [out.mp4] full video, 1920x1080 @ 30fps
+// node render.mjs stills 9.5 22 57 PNG stills at the given seconds, into stills/
+//
+// The page exposes render(t) and DUR; every frame is drawn from t alone, so
+// renders are deterministic and any frame can be inspected in isolation.
+// Set CHROME_PATH to use a specific Chromium build instead of Playwright's.
+import { chromium } from 'playwright-core';
+import { spawn } from 'node:child_process';
+import { mkdirSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+
+const here = dirname(fileURLToPath(import.meta.url));
+const [mode = 'video', ...rest] = process.argv.slice(2);
+const FPS = 30;
+
+const browser = await chromium.launch({ executablePath: process.env.CHROME_PATH || undefined });
+const page = await browser.newPage({ viewport: { width: 1920, height: 1080 }, deviceScaleFactor: 1 });
+page.on('pageerror', (e) => console.error('pageerror:', e.message));
+page.on('console', (m) => { if (m.type() === 'error') console.error('console:', m.text()); });
+await page.goto(pathToFileURL(join(here, 'index.html')).href);
+await page.evaluate(() => document.fonts.ready);
+
+if (mode === 'stills') {
+ mkdirSync(join(here, 'stills'), { recursive: true });
+ for (const t of rest.map(Number)) {
+ await page.evaluate((t) => window.render(t), t);
+ await page.screenshot({ path: join(here, 'stills', `t${t.toFixed(2).padStart(7, '0')}.png`) });
+ }
+} else if (mode === 'video') {
+ const out = rest[0] || join(here, 'weknora-intro.mp4');
+ const dur = await page.evaluate(() => window.DUR);
+ const ff = spawn('ffmpeg', ['-y', '-f', 'image2pipe', '-framerate', String(FPS), '-i', '-',
+ '-c:v', 'libx264', '-preset', 'slow', '-crf', '17', '-pix_fmt', 'yuv420p', '-movflags', '+faststart', out],
+ { stdio: ['pipe', 'ignore', 'inherit'] });
+ const n = Math.round(dur * FPS);
+ for (let f = 0; f < n; f++) {
+ await page.evaluate((t) => window.render(t), f / FPS);
+ const png = await page.screenshot({ type: 'png' });
+ if (!ff.stdin.write(png)) await new Promise((r) => ff.stdin.once('drain', r));
+ if (f % 300 === 0) console.log(`frame ${f}/${n}`);
+ }
+ ff.stdin.end();
+ const code = await new Promise((r) => ff.on('close', r));
+ if (code !== 0) { console.error(`ffmpeg exited with ${code}`); process.exitCode = 1; } else console.log(`wrote ${out}`);
+} else {
+ console.error(`unknown mode "${mode}", expected "video" or "stills"`);
+ process.exitCode = 2;
+}
+await browser.close();