SAM is a smart network built for autonomous AI agents:
- Zero Config: Nodes discover each other and build the P2P network automatically.
- Zero Trust: Every connection, node, and packet is strictly authenticated.
- Agentic 网络: 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 (see the Quick Start Guide): install, add the skill, and your agent is on the mesh.
Advanced demo: an agent fans a batch of work across a warm pool of reviewer agents on the mesh
demo.mp4
Full walkthrough: Warm Agent Pool use case.
sam-control-plane: The registry control plane for node identity registration, authorization policies, and router coordinating.sam-router: The libp2p bootstrap nodes and relays providing data-plane connectivity and forwarding.sam-node: The local node clients providing mesh transport integration and MCP sidecar routing.
Start exploring the Sovereign Agent Mesh:
Get a node running on the public testnet (bananas.sam-mesh.dev) in minutes:
- 🚀 User Quick Start Guide: Connect and run a SAM node using binaries or Docker, and query the local MCP server.
- 🤖 Agent Integration Guides: Connect Google Gemini, Claude, and other AI agents to your SAM node to dynamically discover and call tools across the mesh.
- 📡 Testnet Validation Tutorial: Real-time verification, remote tool invocation, and HTTP stream proxies.
- 🎛️ Production Kubernetes Deployment: Run your own hub (control plane, router, console) via plain manifests, or via the sam-mesh Helm chart for local/self-hosted setups.
Compile from source, run local clusters, or execute tests:
- 🛠️ Developer Guide: Prereqs, compilation, local control plane setup, and Kubernetes Kind deployment.
- 🧪 Testing Guide: Go tests, E2E BATS, and containerized mesh execution.
See LICENSE.
This is not an officially supported Google product. This project is not eligible for the Google Open Source Software Vulnerability Rewards Program.