Open-source design agent: on-brand stills, decks, diagrams, charts and motion graphics from a chat thread, built on Deep Agents.
JavaScript agentagentsai-agentdeepagentsdesignhyperframeslanggraphmanaged-agentsmotion-graphicspaperslackvideo
README: two visuals, the hero and the explainer film
Amal Irgashev26320793e460
diff --git a/AGENTS.md b/AGENTS.mdindex 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 behthe 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 disciplinediff --git a/README.md b/README.mdindex 9b00ee0..b6ec7e5 100644--- a/README.md+++ b/README.md@@ -41,7 +41,7 @@ deployment paths: [Managed Deep Agents](https://docs.langchain.com/langsmith/pytin 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 thepieces. **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 probethat 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.pngdeleted file mode 100644index 9da3077..0000000Binary files a/docs/assets/readme/architecture-dark.png and /dev/null differdiff --git a/docs/assets/readme/architecture-light.png b/docs/assets/readme/architecture-light.pngdeleted file mode 100644index 82edb09..0000000Binary files a/docs/assets/readme/architecture-light.png and /dev/null differdiff --git a/docs/assets/readme/computer-dark.png b/docs/assets/readme/computer-dark.pngdeleted file mode 100644index d428035..0000000Binary files a/docs/assets/readme/computer-dark.png and /dev/null differdiff --git a/docs/assets/readme/computer-light.png b/docs/assets/readme/computer-light.pngdeleted file mode 100644index 4c9f032..0000000Binary files a/docs/assets/readme/computer-light.png and /dev/null differdiff --git a/docs/assets/readme/design-agent-explainer.mp4 b/docs/assets/readme/design-agent-explainer.mp4new file mode 100644index 0000000..18e2f27Binary files /dev/null and b/docs/assets/readme/design-agent-explainer.mp4 differdiff --git a/docs/assets/readme/explainer-preview.gif b/docs/assets/readme/explainer-preview.gifnew file mode 100644index 0000000..8dc84fbBinary files /dev/null and b/docs/assets/readme/explainer-preview.gif differdiff --git a/docs/assets/readme/gallery/dashboard-chart.png b/docs/assets/readme/gallery/dashboard-chart.pngdeleted file mode 100644index e1b7cda..0000000Binary files a/docs/assets/readme/gallery/dashboard-chart.png and /dev/null differdiff --git a/docs/assets/readme/gallery/launch-card.png b/docs/assets/readme/gallery/launch-card.pngdeleted file mode 100644index 9288c81..0000000Binary files a/docs/assets/readme/gallery/launch-card.png and /dev/null differdiff --git a/docs/assets/readme/gallery/slide-diagram.png b/docs/assets/readme/gallery/slide-diagram.pngdeleted file mode 100644index 281cae6..0000000Binary files a/docs/assets/readme/gallery/slide-diagram.png and /dev/null differdiff --git a/docs/assets/readme/gallery/storyboard.jpg b/docs/assets/readme/gallery/storyboard.jpgdeleted file mode 100644index 42eb44e..0000000Binary files a/docs/assets/readme/gallery/storyboard.jpg and /dev/null differdiff --git a/docs/assets/readme/gallery/trace-diagram.png b/docs/assets/readme/gallery/trace-diagram.pngdeleted file mode 100644index 3fc14aa..0000000Binary files a/docs/assets/readme/gallery/trace-diagram.png and /dev/null differdiff --git a/docs/assets/readme/gallery/x-header.png b/docs/assets/readme/gallery/x-header.pngdeleted file mode 100644index 2935d98..0000000Binary files a/docs/assets/readme/gallery/x-header.png and /dev/null differdiff --git a/docs/assets/readme/layers-dark.png b/docs/assets/readme/layers-dark.pngdeleted file mode 100644index 75f2965..0000000Binary files a/docs/assets/readme/layers-dark.png and /dev/null differdiff --git a/docs/assets/readme/layers-light.png b/docs/assets/readme/layers-light.pngdeleted file mode 100644index 8a88c53..0000000Binary files a/docs/assets/readme/layers-light.png and /dev/null differ