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.