agentmesh README

README проекта с github.com/google/agentmesh. Одним файлом markdown: README.md.

Agent Mesh

Agent Mesh

Agent Mesh is a private network for AI agents. A node runs next to an agent and gives it three things: a way to publish tools and models to the network, a way to find and call what other nodes publish, and an identity every other node can verify. Nodes connect directly when they can and through relays when they cannot, so the network works across laptops, containers, clusters and phones behind NAT.

Note: We have updated the name to Agent Mesh to better align with the goals of the project in the ecosystem.

Two properties hold everywhere:

Try it

curl -sL https://google.github.io/agentmesh/install.sh | bash  # agentmesh-node, mcp-client and friends
agentmesh-node join https://bananas.sam-mesh.dev               # one-time login
agentmesh-node run --daemonize                                 # local MCP server on 127.0.0.1:8080
agentmesh-node skill install                                   # teach your agent to use it

Your agent now has tools that discover and call services across the mesh, and an OpenAI-compatible endpoint that routes model requests to whoever serves the model. bananas.sam-mesh.dev is a shared developer testnet with no uptime promise; the quick start walks through it, and your own mesh runs a control plane on your laptop in one command.

To run a control plane of your own without installing anything, open a GitHub codespace with the released binaries and run make testnet. It starts on a public https URL that your laptop and phone can enroll into, on your GitHub account's free quota:

Open in GitHub Codespaces

The Codespaces guide has the steps, what persists and what stops.

What is in a mesh

Program Role
agentmesh-control-plane Verifies who is joining, issues each node a signed credential, and holds the policy that says who may call what.
agentmesh-router A well-known peer that nodes connect to first. Relays traffic between nodes that cannot reach each other and hosts the discovery table.
agentmesh-node Runs next to your agent or service. Enrolls, connects, serves your local backends to the mesh, and exposes the mesh to your agent as a local MCP server and OpenAI-compatible API.
agentmesh-one The control plane, a router and a web console in one binary, for laptops and small deployments.

Documentation

google.github.io/agentmesh/docs is built from site/.

The repository has a dev container with the Go, Node and Python toolchains and Docker, so you can build and test in a codespace or in VS Code without installing anything:

Develop in GitHub Codespaces

Status

Agent Mesh is pre-1.0. The node, routers, control plane, identity and policy model are stable in shape and exercised by the test suite and two public testnets; see ROADMAP.md for the release plan. Sandboxed agent blueprints and the mobile app are in preview.

License and disclaimer

Apache-2.0; see LICENSE. This is not an officially supported Google product, and it is not eligible for the Google Open Source Software Vulnerability Rewards Program.

agentmesh (google/agentmesh)

Ищем в базе…

Что это такое?Agent Mesh — это частная сеть для ИИ-агентов. Узел работает рядом с агентом и позволяет ему публиковать инструменты и модели в сети, находить и вызывать то, что публикуют другие узлы, а также доказывать свою личность каждому другому узлу.
Это один бинарный файл или несколько отдельных сервисов?Он состоит из четырёх программ: control-plane (проверяет узлы и хранит политики), router (передаёт трафик и обеспечивает поиск), node (работает рядом с вашим агентом, открывает локальный MCP-сервер и API, совместимый с OpenAI), а также agentmesh-one, который объединяет control-plane, router и веб-консоль в один бинарный файл для ноутбуков и небольших развёртываний.
Как это запустить?Подключитесь к общей тестовой сети для разработчиков bananas.sam-mesh.dev, следуя краткому руководству, или поднимите собственный control-plane в GitHub Codespace с опубликованными бинарными файлами, выполнив make testnet.
Нужен ли провайдер идентификации, чтобы присоединиться к mesh-сети?Да, узел регистрируется либо с помощью токена OpenID Connect от вашего провайдера идентификации, либо с помощью токена bootstrap, который control-plane превращает в краткоживущие учётные данные, проверяемые без обращения к серверу.
Готов ли проект к промышленной эксплуатации?Нет, Agent Mesh находится в версии до 1.0: узел, маршрутизаторы, control-plane и модель политик стабильны по структуре и проверены в двух публичных тестовых сетях, но изолированные шаблоны агентов и мобильное приложение пока находятся в режиме предварительного просмотра.
Работает ли это только на серверах или ноутбуки и телефоны тоже могут подключиться?Узлы подключаются напрямую, когда это возможно, а в остальных случаях используют ретрансляторы, поэтому mesh работает на ноутбуках, в контейнерах, кластерах и на телефонах за NAT.
Что сеть открывает по умолчанию?По умолчанию ничего не доступно: узел не открывает сервисы, пока его не настроят на это, и ни один узел не может вызвать сервис, который политика сети явно не разрешила. Разрешения проверяются по имени сервиса, а не по сетевому адресу.
Как мой агент на самом деле общается с сетью?Каждый узел предоставляет сеть вашему агенту локально — как MCP-сервер и как конечную точку API, совместимую с OpenAI. Поэтому существующий код вашего агента для вызова инструментов или моделей может обращаться к сервисам и моделям, опубликованным где угодно в сети.
Можно ли попробовать без собственной инфраструктуры?Да, bananas.sam-mesh.dev — это общая тестовая сеть для разработчиков без гарантии времени работы. Подключиться к ней можно напрямую, следуя краткому руководству.
Можно ли развернуть это в Kubernetes или Cloud Run вместо ноутбука?Да, в документации есть руководства по развёртыванию в Kubernetes и Cloud Run, а также инструкция по настройке agentmesh-one для ноутбука.
Что означает тег a2a-protocol для этого проекта?Agent Mesh строит сеть, в которой узлы находят и вызывают опубликованные инструменты и модели друг друга под проверяемой личностью и по явной политике разрешений. Это модель связи агент-агент (A2A), которую реализует проект.
Какие есть похожие проекты?casdoor, netmaker, hydra, archestra, oauth2-proxy, kratos, dex, bifrost
Автор
google
Размер
84.9 MB
Звёзды
1.2K
Возраст
6 мес
Коммиты · 90 дней