SAM: Sovereign Agent Mesh

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 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 (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
Full walkthrough: Warm Agent Pool use case.
Architecture Components
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.
Documentation
Start exploring the Sovereign Agent Mesh:
For Users & Operators
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.
For Developers & Contributors
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.
License
See LICENSE.
Disclaimer
This is not an officially supported Google product. This project is not eligible for the Google Open Source Software Vulnerability Rewards Program.