Skip to content

Agent Mesh

23.1 KB
Raw Blame
<!doctype html>
<html lang="{{ .Site.Language.Lang }}" class="no-js" data-bs-theme="dark">

<head>
  {{ partial "head.html" . }}
</head>

<body class="agentmesh-landing-page">
  <div class="mesh-grid"></div>
  <div class="mesh-glow-cyan"></div>
  <div class="mesh-glow-yellow"></div>

  <!-- Top Navigation -->
  <header class="am-topbar">
    <div class="am-topbar-inner">
      <a href="{{ "" | relURL }}" class="am-brand">
        <img src="{{ "favicon.png" | relURL }}" alt="Agent Mesh">
        <span>Agent Mesh</span>
      </a>
      <nav class="am-nav-links" aria-label="Landing navigation">
        <a href="#how-it-works">How It Works</a>
        <a href="#what-it-is">What It Is</a>
        <a href="#deployment">Deployment</a>
        <a href="#security">Security</a>
        <a href="#demos">Demos</a>
      </nav>
      <div class="am-nav-cta">
        <a href="{{ "docs/" | relURL }}" class="btn-sleek btn-cyan btn-sm">Docs</a>
        <a href="{{ .Site.Params.github_repo }}" target="_blank" rel="noopener" class="btn-sleek btn-dark btn-sm">GitHub</a>
      </div>
    </div>
  </header>

  <!-- 1. HERO + QUICKSTART TERMINAL -->
  <div class="landing-container">
    <div class="hero-brand-col">
      <div class="logo-row">
        <div class="logo-container">
          <div class="logo-backdrop-glow"></div>
          <img src="{{ "favicon.png" | relURL }}" alt="Agent Mesh Logo" class="agentmesh-hero-logo">
        </div>
        <div>
          <h1 class="landing-title">Agent Mesh</h1>
          <p class="landing-subtitle">Zero-Trust Agent Network</p>
        </div>
      </div>

      <p class="landing-description">
        Connect agents, tools, and models across <strong>laptops</strong>, <strong>isolated sandboxes</strong>, and <strong>Kubernetes</strong>—without opening ports or sharing API keys.
      </p>

      <div class="scheme-pills">
        <span class="scheme-pill"><span class="sp-dot"></span>mcp:// <span class="sp-label">tools</span></span>
        <span class="scheme-pill"><span class="sp-dot"></span>a2a:// <span class="sp-label">agents</span></span>
        <span class="scheme-pill"><span class="sp-dot"></span>inference:// <span class="sp-label">models</span></span>
        <span class="scheme-pill"><span class="sp-dot"></span>egress:// <span class="sp-label">APIs</span></span>
      </div>

      <div class="landing-actions">
        <a href="{{ "docs/getting-started/your-own-mesh/" | relURL }}" class="btn-sleek btn-cyan">Get Started</a>
        <a href="{{ "docs/" | relURL }}" class="btn-sleek btn-dark">Documentation</a>
        <a href="{{ .Site.Params.github_repo }}" target="_blank" rel="noopener" class="btn-sleek btn-dark">GitHub</a>
      </div>
    </div>

    <div class="hero-terminal-col">
      <div class="terminal-window">
        <div class="terminal-header">
          <div class="terminal-buttons">
            <span class="btn-circle btn-red"></span>
            <span class="btn-circle btn-yellow"></span>
            <span class="btn-circle btn-green"></span>
          </div>
          <span class="terminal-title">bash — run your own mesh</span>
          <button type="button" class="terminal-copy" data-copy-text="curl -sL https://google.github.io/agentmesh/install.sh | bash&#10;agentmesh-one --data-dir ~/mesh --port 8080 &amp;&#10;agentmesh-node join http://127.0.0.1:8080 --bootstrap-token-path ~/mesh/join-token&#10;agentmesh-node run --daemonize&#10;agentmesh-node skill install">Copy</button>
        </div>
        <div class="terminal-body">
          <div class="terminal-line"><span class="t-comment"># 1. Install agentmesh-one and agentmesh-node</span></div>
          <div class="terminal-line"><span class="t-prompt">$</span><span class="t-cmd">curl -sL https://google.github.io/agentmesh/install.sh | bash</span></div>
          <div class="terminal-line"><span class="t-comment"># 2. Start control plane, router &amp; web console</span></div>
          <div class="terminal-line"><span class="t-prompt">$</span><span class="t-cmd">agentmesh-one --data-dir ~/mesh --port 8080 &amp;</span></div>
          <div class="terminal-line"><span class="t-comment"># 3. Enroll a node and start it in the background</span></div>
          <div class="terminal-line"><span class="t-prompt">$</span><span class="t-cmd">agentmesh-node join http://127.0.0.1:8080 \</span></div>
          <div class="terminal-line"><span class="t-output">    --bootstrap-token-path ~/mesh/join-token</span></div>
          <div class="terminal-line"><span class="t-prompt">$</span><span class="t-cmd">agentmesh-node run --daemonize</span></div>
          <div class="terminal-line"><span class="t-comment"># 4. Give your agent the mesh skill</span></div>
          <div class="terminal-line"><span class="t-prompt">$</span><span class="t-cmd">agentmesh-node skill install</span></div>
          <div class="terminal-line"><span class="t-success">✓ Ready — Console at http://127.0.0.1:8080/console</span></div>
        </div>
      </div>
    </div>
  </div>

  <!-- 2. HOW IT WORKS (VISUAL ARCHITECTURE) -->
  <section class="am-section" id="how-it-works">
    <div class="am-section-head">
      <span class="am-tag">Architecture</span>
      <h2>How a Request Travels the Mesh</h2>
      <p>Nothing is reachable by default. Nodes dial outbound over QUIC/TLS 1.3 and verify every call by service name.</p>
    </div>

    <div class="am-diagram-frame">
      <img src="{{ "images/agent-mesh-flow.svg" | relURL }}" alt="Agent Mesh request flow across nodes, router, and control plane">
    </div>

    <div class="am-grid-3">
      <div class="am-card">
        <span class="am-card-badge">agentmesh-control-plane</span>
        <h3>Identity &amp; Policy</h3>
        <p>Verifies OIDC or bootstrap tokens, compiles Datalog policies, and signs short-lived Biscuit credentials. Off the data path.</p>
      </div>
      <div class="am-card">
        <span class="am-card-badge badge-yellow">agentmesh-router</span>
        <h3>Discovery &amp; Relay</h3>
        <p>Runs the Kademlia DHT and relays encrypted streams across NATs and firewalls without seeing plaintext payloads.</p>
      </div>
      <div class="am-card">
        <span class="am-card-badge">agentmesh-node</span>
        <h3>Local Data-Plane Proxy</h3>
        <p>Runs beside your agent. Publishes and calls <code>mcp://</code>, <code>a2a://</code>, <code>inference://</code>, and <code>egress://</code> over HTTP.</p>
      </div>
    </div>
  </section>

  <!-- 3. WHAT IT IS vs WHAT IT IS NOT -->
  <section class="am-section" id="what-it-is">
    <div class="am-section-head">
      <span class="am-tag">Mental Model</span>
      <h2>What Agent Mesh Is — And What It Isn't</h2>
      <p>Purpose-built for agent protocols rather than raw IP packets.</p>
    </div>

    <div class="am-grid-3">
      <div class="am-card am-card-warn">
        <span class="am-card-badge badge-red">NOT A FLAT L3 VPN</span>
        <h3>Named Services, Not Open IPs</h3>
        <p>No virtual network interfaces or exposed machine ports (<code>--network=none</code>). Peers can only invoke published service names.</p>
      </div>
      <div class="am-card">
        <span class="am-card-badge">NOT SINGLE-CLUSTER ONLY</span>
        <h3>Spans Every Environment</h3>
        <p>Connects agents on laptops, isolated sandboxes, VMs, and <strong>Kubernetes</strong> clusters over one peer-to-peer overlay.</p>
      </div>
      <div class="am-card">
        <span class="am-card-badge badge-yellow">NOT A SILOED GATEWAY</span>
        <h3>Plugs Into Your Proxies</h3>
        <p>Integrates with <strong>Envoy</strong> (<code>ext_proc</code>, <code>ext_authz</code>), <strong>Istio</strong>, and <strong>agent gateways</strong> via standard HTTP and OAuth token exchange.</p>
      </div>
    </div>
  </section>

  <!-- 4. DEPLOYMENT MODELS (4 INTERACTIVE TABS) -->
  <section class="am-section" id="deployment">
    <div class="am-section-head">
      <span class="am-tag">Deployment Models</span>
      <h2>Four Ways to Run It</h2>
      <p>Pick the footprint that matches your environment—all four speak the same mesh protocol.</p>
    </div>

    <div class="am-tabs" role="tablist">
      <button type="button" class="am-tab-btn active" data-tab="dep-node" id="tab-dep-node" role="tab" aria-selected="true" aria-controls="dep-node">
        <span class="t-num">01 · SIDECAR / CLI</span>
        <span class="t-name">Local Node &amp; SKILL.md</span>
      </button>
      <button type="button" class="am-tab-btn" data-tab="dep-sandbox" id="tab-dep-sandbox" role="tab" aria-selected="false" aria-controls="dep-sandbox">
        <span class="t-num">02 · ZERO SECRETS</span>
        <span class="t-name">Isolated Sandboxes</span>
      </button>
      <button type="button" class="am-tab-btn" data-tab="dep-gateway" id="tab-dep-gateway" role="tab" aria-selected="false" aria-controls="dep-gateway">
        <span class="t-num">03 · ENVOY &amp; GATEWAYS</span>
        <span class="t-name">ext_proc &amp; ext_authz</span>
      </button>
      <button type="button" class="am-tab-btn" data-tab="dep-sdk" id="tab-dep-sdk" role="tab" aria-selected="false" aria-controls="dep-sdk">
        <span class="t-num">04 · IN-PROCESS</span>
        <span class="t-name">Python &amp; JS SDKs</span>
      </button>
    </div>

    <!-- Tab 1: Local Node -->
    <div class="am-tab-panel active" id="dep-node" role="tabpanel" aria-labelledby="tab-dep-node">
      <div>
        <h3>Sidecar or Local Daemon with <code>SKILL.md</code></h3>
        <p>Run <code>agentmesh-node</code> on a laptop, VM, or <strong>Kubernetes</strong> pod. Agents learn how to discover and call mesh services automatically via a local <code>SKILL.md</code> or MCP server.</p>
        <div class="am-flow">
          <div class="am-flow-node">
            <span class="fn-title">Agent CLI</span>
            <span class="fn-sub">reads SKILL.md</span>
          </div>
          <span class="am-flow-arrow">→</span>
          <div class="am-flow-node node-cyan">
            <span class="fn-title">agentmesh-node</span>
            <span class="fn-sub">127.0.0.1:8080</span>
          </div>
          <span class="am-flow-arrow">→</span>
          <div class="am-flow-node node-yellow">
            <span class="fn-title">Remote Peer</span>
            <span class="fn-sub">QUIC / TLS 1.3</span>
          </div>
        </div>
      </div>
      <div class="terminal-window">
        <div class="terminal-header">
          <div class="terminal-buttons"><span class="btn-circle btn-red"></span><span class="btn-circle btn-yellow"></span><span class="btn-circle btn-green"></span></div>
          <span class="terminal-title">config.yaml — publish local services</span>
        </div>
        <div class="terminal-body">
          <div class="terminal-line"><span class="t-prompt">version:</span> <span class="t-cmd">"v1alpha1"</span></div>
          <div class="terminal-line"><span class="t-prompt">services:</span></div>
          <div class="terminal-line"><span class="t-cmd">  - type: mcp</span></div>
          <div class="terminal-line"><span class="t-output">    name: orders-db</span></div>
          <div class="terminal-line"><span class="t-output">    target_url: "http://127.0.0.1:3001/mcp"</span></div>
          <div class="terminal-line"><span class="t-cmd">  - type: inference</span></div>
          <div class="terminal-line"><span class="t-output">    name: local-llm</span></div>
          <div class="terminal-line"><span class="t-output">    target_url: "http://127.0.0.1:11434"</span></div>
        </div>
      </div>
    </div>

    <!-- Tab 2: Sandboxes -->
    <div class="am-tab-panel" id="dep-sandbox" role="tabpanel" aria-labelledby="tab-dep-sandbox">
      <div>
        <h3>Isolated Sandboxes with Zero API Keys</h3>
        <p>Run untrusted code inside a container or microVM with <code>0</code> secrets in memory. The sandbox talks plain HTTP to <code>agentmesh-node</code> outside the boundary, which authenticates and injects credentials on egress.</p>
        <div class="am-flow">
          <div class="am-flow-node">
            <span class="fn-title">Sandbox</span>
            <span class="fn-sub">0 keys in RAM</span>
          </div>
          <span class="am-flow-arrow">→</span>
          <div class="am-flow-node node-cyan">
            <span class="fn-title">Host Node</span>
            <span class="fn-sub">Biscuit verify</span>
          </div>
          <span class="am-flow-arrow">→</span>
          <div class="am-flow-node node-yellow">
            <span class="fn-title">egress:// API</span>
            <span class="fn-sub">injects secret</span>
          </div>
        </div>
      </div>
      <div class="terminal-window">
        <div class="terminal-header">
          <div class="terminal-buttons"><span class="btn-circle btn-red"></span><span class="btn-circle btn-yellow"></span><span class="btn-circle btn-green"></span></div>
          <span class="terminal-title">inside isolated sandbox</span>
        </div>
        <div class="terminal-body">
          <div class="terminal-line"><span class="t-comment"># Route outbound HTTP through the host node</span></div>
          <div class="terminal-line"><span class="t-prompt">$</span><span class="t-cmd">export HTTPS_PROXY=http://host.internal:8080</span></div>
          <div class="terminal-line"><span class="t-comment"># Call external API without holding API keys</span></div>
          <div class="terminal-line"><span class="t-prompt">$</span><span class="t-cmd">curl https://api.github.com/repos/google/agentmesh</span></div>
          <div class="terminal-line"><span class="t-success">✓ Egress node verified policy &amp; injected token</span></div>
        </div>
      </div>
    </div>

    <!-- Tab 3: Gateways & Envoy -->
    <div class="am-tab-panel" id="dep-gateway" role="tabpanel" aria-labelledby="tab-dep-gateway">
      <div>
        <h3>Gateways, Istio &amp; Envoy (<code>ext_proc</code> / <code>ext_authz</code>)</h3>
        <p>Plug <code>agentmesh-node</code> into <strong>Envoy</strong>, <strong>Istio</strong>, and <strong>agent gateways</strong>. Exchange platform JWTs at <code>/oauth/token</code> (RFC 8693) into task Biscuits and enforce policy on every tool call.</p>
        <div class="am-flow">
          <div class="am-flow-node">
            <span class="fn-title">Workload JWT</span>
            <span class="fn-sub">OIDC / K8s SA</span>
          </div>
          <span class="am-flow-arrow">→</span>
          <div class="am-flow-node node-cyan">
            <span class="fn-title">Envoy / Gateway</span>
            <span class="fn-sub">ext_authz · ext_proc</span>
          </div>
          <span class="am-flow-arrow">→</span>
          <div class="am-flow-node node-yellow">
            <span class="fn-title">Mesh Service</span>
            <span class="fn-sub">Datalog check</span>
          </div>
        </div>
      </div>
      <div class="terminal-window">
        <div class="terminal-header">
          <div class="terminal-buttons"><span class="btn-circle btn-red"></span><span class="btn-circle btn-yellow"></span><span class="btn-circle btn-green"></span></div>
          <span class="terminal-title">RFC 8693 token exchange</span>
        </div>
        <div class="terminal-body">
          <div class="terminal-line"><span class="t-prompt">$</span><span class="t-cmd">curl -X POST http://127.0.0.1:8080/oauth/token \</span></div>
          <div class="terminal-line"><span class="t-output">  -d "grant_type=urn:ietf:params:oauth:grant-type:\</span></div>
          <div class="terminal-line"><span class="t-output">token-exchange" \</span></div>
          <div class="terminal-line"><span class="t-output">  -d "subject_token=$WORKLOAD_JWT" \</span></div>
          <div class="terminal-line"><span class="t-output">  -d "resource=mcp://orders-db"</span></div>
          <div class="terminal-line"><span class="t-success">✓ Issued attenuated Biscuit for mcp://orders-db</span></div>
        </div>
      </div>
    </div>

    <!-- Tab 4: Native SDKs -->
    <div class="am-tab-panel" id="dep-sdk" role="tabpanel" aria-labelledby="tab-dep-sdk">
      <div>
        <h3>In-Process Python &amp; TypeScript SDKs</h3>
        <p>Embed Agent Mesh directly in your agent harness. Narrow permissions offline in microseconds with <code>session.attenuate()</code> before delegating to a sub-agent.</p>
        <div class="am-flow">
          <div class="am-flow-node">
            <span class="fn-title">Parent Agent</span>
            <span class="fn-sub">Block 0 Biscuit</span>
          </div>
          <span class="am-flow-arrow">→</span>
          <div class="am-flow-node node-cyan">
            <span class="fn-title">attenuate()</span>
            <span class="fn-sub">+ tar_block</span>
          </div>
          <span class="am-flow-arrow">→</span>
          <div class="am-flow-node node-yellow">
            <span class="fn-title">Sub-Agent</span>
            <span class="fn-sub">read-only scope</span>
          </div>
        </div>
      </div>
      <div class="terminal-window">
        <div class="terminal-header">
          <div class="terminal-buttons"><span class="btn-circle btn-red"></span><span class="btn-circle btn-yellow"></span><span class="btn-circle btn-green"></span></div>
          <span class="terminal-title">subagent.py — offline attenuation</span>
        </div>
        <div class="terminal-body">
          <div class="terminal-line"><span class="t-prompt">from</span> <span class="t-cmd">agentmesh</span> <span class="t-prompt">import</span> <span class="t-cmd">MeshSession, Rule</span></div>
          <div class="terminal-line"><span class="t-cmd">sub = session.attenuate([</span></div>
          <div class="terminal-line"><span class="t-output">    Rule(service="orders-db", action="mcp:call",</span></div>
          <div class="terminal-line"><span class="t-output">         resource="mcp://orders-db/tools/list_orders")</span></div>
          <div class="terminal-line"><span class="t-cmd">]).seal()</span></div>
          <div class="terminal-line"><span class="t-success"># Sub-agent cannot call delete_order</span></div>
        </div>
      </div>
    </div>
  </section>

  <!-- 5. SECURITY POSTURE (3 COMPACT CARDS) -->
  <section class="am-section" id="security">
    <div class="am-section-head">
      <span class="am-tag">Security Posture</span>
      <h2>Zero Trust Without the Boilerplate</h2>
      <p>Cryptographic tokens bound to the transport connection and verified locally at every hop.</p>
    </div>

    <div class="am-grid-3">
      <div class="am-card">
        <span class="am-card-badge">01 · CHANNEL BINDING</span>
        <h3>Stolen Tokens Are Useless</h3>
        <p>Every Biscuit embeds the node's <code>Ed25519 PeerID</code> in <code>Block 0</code>, verified against the live <code>QUIC / TLS 1.3</code> handshake.</p>
      </div>
      <div class="am-card">
        <span class="am-card-badge badge-yellow">02 · DATALOG + TAR_BLOCK</span>
        <h3>Per-Task Least Privilege</h3>
        <p>Verifiers require both the control plane's <code>Block 0</code> Datalog policy and every appended sub-agent <code>tar_block</code> to pass.</p>
      </div>
      <div class="am-card">
        <span class="am-card-badge">03 · BORDER BROKERING</span>
        <h3>Secrets Stay at the Edge</h3>
        <p>Agents use Biscuits inside the mesh; border nodes mint short-lived OAuth / STS JWTs or inject API keys on egress.</p>
      </div>
    </div>
  </section>

  <!-- 6. LIVE DEMOS & DOCS -->
  <section class="am-section" id="demos">
    <div class="am-section-head">
      <span class="am-tag">See It In Action</span>
      <h2>Walkthroughs &amp; Documentation</h2>
      <p>Watch Agent Mesh running live or jump straight into the guides.</p>
    </div>

    <div class="am-grid-3" style="margin-bottom: 2.5rem;">
      <div class="am-video-card">
        <video controls preload="metadata" src="{{ "demo-sandboxed-agent.mp4" | relURL }}"></video>
        <div class="am-vc-caption">
          <span>Sandboxed Agents (Zero Keys)</span>
          <a href="{{ "docs/preview/sandboxed-agents/" | relURL }}">Docs →</a>
        </div>
      </div>
      <div class="am-video-card">
        <video controls preload="metadata" src="{{ "demo-multi-tier-guardrails.mp4" | relURL }}"></video>
        <div class="am-vc-caption">
          <span>Policy &amp; Task Attenuation</span>
          <a href="{{ "docs/use-cases/multi-tier-guardrails/" | relURL }}">Docs →</a>
        </div>
      </div>
      <div class="am-video-card">
        <video controls preload="metadata" src="{{ "demo-warm-agent-pool.mp4" | relURL }}"></video>
        <div class="am-vc-caption">
          <span>Warm Agent Pools Across Nodes</span>
          <a href="{{ "docs/use-cases/" | relURL }}">Docs →</a>
        </div>
      </div>
    </div>

    <div class="am-grid-4">
      <a href="{{ "docs/getting-started/" | relURL }}" class="am-doc-link">
        <div class="dl-title">Getting Started <span>→</span></div>
        <p>Install the CLI, run <code>agentmesh-one</code> locally, and connect your first nodes.</p>
      </a>
      <a href="{{ "docs/concepts/" | relURL }}" class="am-doc-link">
        <div class="dl-title">Core Concepts <span>→</span></div>
        <p>Learn how identity, Biscuits, Datalog policies, and P2P routing work.</p>
      </a>
      <a href="{{ "docs/guides/" | relURL }}" class="am-doc-link">
        <div class="dl-title">Operator Guides <span>→</span></div>
        <p>Deploy on Kubernetes, expose services, and configure egress.</p>
      </a>
      <a href="{{ "docs/reference/" | relURL }}" class="am-doc-link">
        <div class="dl-title">CLI &amp; API Reference <span>→</span></div>
        <p>Flags, HTTP endpoints, protobuf schema, and Python/JS SDKs.</p>
      </a>
    </div>
  </section>

  <footer class="am-footer">
    Agent Mesh · Apache 2.0 ·
    <a href="{{ "docs/" | relURL }}">Documentation</a> ·
    <a href="{{ "docs/getting-started/quickstart/" | relURL }}">Quickstart</a> ·
    <a href="{{ .Site.Params.github_repo }}" target="_blank" rel="noopener">GitHub</a>
  </footer>

  <script>
    (function () {
      // Deployment tabs switcher
      var buttons = document.querySelectorAll('.am-tab-btn');
      var panels = document.querySelectorAll('.am-tab-panel');
      buttons.forEach(function (btn) {
        btn.addEventListener('click', function () {
          var target = btn.getAttribute('data-tab');
          buttons.forEach(function (b) {
            b.classList.remove('active');
            b.setAttribute('aria-selected', 'false');
          });
          panels.forEach(function (p) { p.classList.remove('active'); });
          btn.classList.add('active');
          btn.setAttribute('aria-selected', 'true');
          var el = document.getElementById(target);
          if (el) el.classList.add('active');
        });
      });

      // Terminal copy button
      var copyBtn = document.querySelector('.terminal-copy');
      if (copyBtn && navigator.clipboard) {
        copyBtn.addEventListener('click', function () {
          var text = copyBtn.getAttribute('data-copy-text');
          navigator.clipboard.writeText(text).then(function () {
            var orig = copyBtn.textContent;
            copyBtn.textContent = 'Copied!';
            setTimeout(function () { copyBtn.textContent = orig; }, 1600);
          });
        });
      }
    })();
  </script>

  {{ partial "scripts.html" . }}
</body>

</html>