Skip to content

Agent Mesh

add simple demo

Antonio Ojea05f593b565f3
diff --git a/README.md b/README.md
index aaa299e4..8ce6257c 100644
--- a/README.md
+++ b/README.md
@@ -9,8 +9,19 @@ SAM is a smart network built for autonomous AI agents:
* **Agentic Network:** Formed by lightweight nodes (`sam-node`) that provide self-healing, P2P connectivity, allowing autonomous agents to plug in, communicate, and invoke tools dynamically.
* **Portability:** Cryptographic identities are environment-agnostic, allowing seamless node mobility across cloud, local, and edge environments.
+Getting started is a one-liner: install, add the skill, and your agent is on the mesh.
+
+<img src="site/static/demo.gif" alt="Demo: installing SAM, adding the sam-mesh skill, and an agent discovering and calling tools across the mesh" width="100%" />
+
+<details>
+<summary><b>Advanced demo</b>: an agent fans a batch of work across a warm pool of reviewer agents on the mesh</summary>
+
<video src="https://github.com/user-attachments/assets/f1a61b6f-efcd-46d8-a6e6-659fb29dd1ce" width="100%" autoplay loop muted playsinline controls></video>
+Full walkthrough: [Warm Agent Pool use case](site/content/docs/use-cases/warm-agent-pool.md).
+
+</details>
+
---
## Architecture Components
diff --git a/site/content/docs/use-cases/warm-agent-pool.md b/site/content/docs/use-cases/warm-agent-pool.md
index 9d670034..a6761722 100644
--- a/site/content/docs/use-cases/warm-agent-pool.md
+++ b/site/content/docs/use-cases/warm-agent-pool.md
@@ -7,6 +7,10 @@ weight: 10
Fan a batch of work across a pool of identical, already-running worker agents —
built entirely from ordinary mesh MCP services, no gossip and no node changes.
+<video autoplay loop muted playsinline controls style="width: 100%; border-radius: 8px;">
+ <source src="/demo-warm-agent-pool.mp4" type="video/mp4">
+</video>
+
Source: [`development/examples/code-reviewer-pool/`](https://github.com/google/sam/tree/main/development/examples/code-reviewer-pool).
## The idea
diff --git a/site/static/demo-warm-agent-pool.mp4 b/site/static/demo-warm-agent-pool.mp4
new file mode 100644
index 00000000..c0601bb2
Binary files /dev/null and b/site/static/demo-warm-agent-pool.mp4 differ
diff --git a/site/static/demo.gif b/site/static/demo.gif
new file mode 100644
index 00000000..ecc687fc
Binary files /dev/null and b/site/static/demo.gif differ
diff --git a/site/static/demo.mp4 b/site/static/demo.mp4
index c0601bb2..189c2c4a 100644
Binary files a/site/static/demo.mp4 and b/site/static/demo.mp4 differ