Skip to content

Open-source design agent: on-brand stills, decks, diagrams, charts and motion graphics from a chat thread, built on Deep Agents.

README: two visuals, the hero and the explainer film

Amal Irgashev26320793e460
diff --git a/AGENTS.md b/AGENTS.md
index 747bf2c..49ae618 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -72,8 +72,8 @@ Code and tests are the source of truth; `SPEC.md` records the product intent beh
the brand folder. Large results go to files with compact summaries.
- Do not copy private company data, internal people, channels, accounts, licensed fonts,
third-party footage or internal implementation notes into this repository. LangChain's brand
- appears only in the README and `docs/assets/readme/` (the project's own presentation, exported
- from its Paper designs); the agent's sample brand, skills, examples and tests stay brand-neutral.
+ appears only in the README and `docs/assets/readme/` (the project's own presentation: figures
+ exported from its Paper designs and its explainer film); the agent's sample brand, skills, examples and tests stay brand-neutral.
## Change discipline
diff --git a/README.md b/README.md
index 9b00ee0..b6ec7e5 100644
--- a/README.md
+++ b/README.md
@@ -41,7 +41,7 @@ deployment paths: [Managed Deep Agents](https://docs.langchain.com/langsmith/pyt
in one command, or self-hosted with Docker.
> [!NOTE]
-> The figures and samples in this README use LangChain's brand, the brand we run it with. Design Agent
+> The images and film in this README use LangChain's brand, the brand we run it with. Design Agent
> ships with an original sample brand, and every output follows the brand pack you give it: build
> yours with the [brand-onboarding skill](.agents/skills/brand-onboarding/SKILL.md).
@@ -52,23 +52,6 @@ in one command, or self-hosted with Docker.
## What it makes
-<table>
- <tr>
- <td width="50%"><img src="docs/assets/readme/gallery/slide-diagram.png" alt="A light-mode opening slide: two people, one agent, private user memories and one shared agent memory"><br><sub><b>Slides and diagrams.</b> An opening slide for a technical demo.</sub></td>
- <td width="50%"><img src="docs/assets/readme/gallery/trace-diagram.png" alt="A dark trace diagram of a travel-booking agent with the wrong-date tool call flagged in red"><br><sub><b>Explainers.</b> An agent trace with the faulty step flagged.</sub></td>
- </tr>
- <tr>
- <td width="50%"><img src="docs/assets/readme/gallery/dashboard-chart.png" alt="A light-mode dashboard of online evaluation costs over time as stacked bars"><br><sub><b>Charts.</b> Rendered from data; every number computed in code.</sub></td>
- <td width="50%"><img src="docs/assets/readme/gallery/launch-card.png" alt="A dark 1200 by 630 card: Deploy your agent with one command"><br><sub><b>Social cards.</b> This one came from a deployed agent over the API.</sub></td>
- </tr>
- <tr>
- <td colspan="2"><img src="docs/assets/readme/gallery/x-header.png" alt="A dark X header with converging dots and the line: your iteration engine for building reliable agents"><br><sub><b>Banners and headers</b>, sized for each platform.</sub></td>
- </tr>
- <tr>
- <td colspan="2"><img src="docs/assets/readme/gallery/storyboard.jpg" alt="The first frames of a storyboard for a 45-second film about scheduled agent runs, with timing, motion and sound notes under each frame"><br><sub><b>Motion.</b> Storyboard first, with timing, motion and sound for every frame; then a HyperFrames film.</sub></td>
- </tr>
-</table>
-
- **Stills and sets:** layouts rendered in a real browser, each size recomposed rather than scaled;
PDFs and decks; image edits; GIFs.
- **Diagrams and charts:** JSON specs rendered with ECharts and D2 on your brand, with the numbers
@@ -83,10 +66,10 @@ in one command, or self-hosted with Docker.
## How it works
-<picture>
- <source media="(prefers-color-scheme: dark)" srcset="docs/assets/readme/layers-dark.png">
- <img src="docs/assets/readme/layers-light.png" alt="The layers: what we built (the lead and its helpers, the context, the designer's computer) on top of what comes off the shelf (Managed Deep Agents, Deep Agents, the model)" width="100%">
-</picture>
+<p align="center">
+ <a href="docs/assets/readme/design-agent-explainer.mp4"><img src="docs/assets/readme/explainer-preview.gif" alt="From the explainer film: the lead hands out a film in three acts, and a flock of helper parrots works the act folders in parallel" width="100%"></a>
+ <br><sub><b><a href="docs/assets/readme/design-agent-explainer.mp4">Watch the 2-minute film</a></b>: a Slack request moving through the sandbox, skills, Paper, the helpers, HyperFrames, the checks and the sound.</sub>
+</p>
Three layers are specific to design work. **The lead and its helpers** plan the job and hand out the
pieces. **The context** is skills, a design wiki, the brand pack and memory, loaded only when a job
@@ -97,11 +80,6 @@ measures, runs the gates, delivers files and holds the credentials.
## Architecture
-<picture>
- <source media="(prefers-color-scheme: dark)" srcset="docs/assets/readme/architecture-dark.png">
- <img src="docs/assets/readme/architecture-light.png" alt="Architecture on Managed Deep Agents: Slack, sandboxes and schedules; the lead and its helpers, the context folders and the designer's computer; the Deep Agents harness and the model; host tools and MCP servers outside, where the keys stay" width="100%">
-</picture>
-
One assembly (`src/design_agent/assembly.py`) builds the model, tools, middleware and helpers.
Runtime profiles plug it into each place it runs: Managed Deep Agents, the CLI, the self-hosted API,
Slack and schedules.
@@ -133,11 +111,6 @@ Slack and schedules.
### The designer's computer
-<picture>
- <source media="(prefers-color-scheme: dark)" srcset="docs/assets/readme/computer-dark.png">
- <img src="docs/assets/readme/computer-light.png" alt="The designer's computer: a workspace with job, skills, wiki, video kit and memory folders; HTML layers and image scripts; a video engine of HyperFrames, Chrome and FFmpeg; charts and diagrams; host tools and MCP servers outside with the keys" width="100%">
-</picture>
-
- **One recipe for every sandbox.** [`sandbox/setup.sh`](sandbox/) pins Chrome Headless Shell,
FFmpeg, HyperFrames, sharp, ECharts, D2 and open fonts by version and sha256. It ends with a probe
that renders a page, a film and a diagram. The same recipe builds:
diff --git a/docs/assets/readme/architecture-dark.png b/docs/assets/readme/architecture-dark.png
deleted file mode 100644
index 9da3077..0000000
Binary files a/docs/assets/readme/architecture-dark.png and /dev/null differ
diff --git a/docs/assets/readme/architecture-light.png b/docs/assets/readme/architecture-light.png
deleted file mode 100644
index 82edb09..0000000
Binary files a/docs/assets/readme/architecture-light.png and /dev/null differ
diff --git a/docs/assets/readme/computer-dark.png b/docs/assets/readme/computer-dark.png
deleted file mode 100644
index d428035..0000000
Binary files a/docs/assets/readme/computer-dark.png and /dev/null differ
diff --git a/docs/assets/readme/computer-light.png b/docs/assets/readme/computer-light.png
deleted file mode 100644
index 4c9f032..0000000
Binary files a/docs/assets/readme/computer-light.png and /dev/null differ
diff --git a/docs/assets/readme/design-agent-explainer.mp4 b/docs/assets/readme/design-agent-explainer.mp4
new file mode 100644
index 0000000..18e2f27
Binary files /dev/null and b/docs/assets/readme/design-agent-explainer.mp4 differ
diff --git a/docs/assets/readme/explainer-preview.gif b/docs/assets/readme/explainer-preview.gif
new file mode 100644
index 0000000..8dc84fb
Binary files /dev/null and b/docs/assets/readme/explainer-preview.gif differ
diff --git a/docs/assets/readme/gallery/dashboard-chart.png b/docs/assets/readme/gallery/dashboard-chart.png
deleted file mode 100644
index e1b7cda..0000000
Binary files a/docs/assets/readme/gallery/dashboard-chart.png and /dev/null differ
diff --git a/docs/assets/readme/gallery/launch-card.png b/docs/assets/readme/gallery/launch-card.png
deleted file mode 100644
index 9288c81..0000000
Binary files a/docs/assets/readme/gallery/launch-card.png and /dev/null differ
diff --git a/docs/assets/readme/gallery/slide-diagram.png b/docs/assets/readme/gallery/slide-diagram.png
deleted file mode 100644
index 281cae6..0000000
Binary files a/docs/assets/readme/gallery/slide-diagram.png and /dev/null differ
diff --git a/docs/assets/readme/gallery/storyboard.jpg b/docs/assets/readme/gallery/storyboard.jpg
deleted file mode 100644
index 42eb44e..0000000
Binary files a/docs/assets/readme/gallery/storyboard.jpg and /dev/null differ
diff --git a/docs/assets/readme/gallery/trace-diagram.png b/docs/assets/readme/gallery/trace-diagram.png
deleted file mode 100644
index 3fc14aa..0000000
Binary files a/docs/assets/readme/gallery/trace-diagram.png and /dev/null differ
diff --git a/docs/assets/readme/gallery/x-header.png b/docs/assets/readme/gallery/x-header.png
deleted file mode 100644
index 2935d98..0000000
Binary files a/docs/assets/readme/gallery/x-header.png and /dev/null differ
diff --git a/docs/assets/readme/layers-dark.png b/docs/assets/readme/layers-dark.png
deleted file mode 100644
index 75f2965..0000000
Binary files a/docs/assets/readme/layers-dark.png and /dev/null differ
diff --git a/docs/assets/readme/layers-light.png b/docs/assets/readme/layers-light.png
deleted file mode 100644
index 8a88c53..0000000
Binary files a/docs/assets/readme/layers-light.png and /dev/null differ