Show & tell: running A2A agents on Kubernetes with Kynomesh

[whynowy]

Hi everyone,

I'd like to share Kynomesh, an open source project that runs A2A agents on Kubernetes, and ask this community for feedback.

Repo: https://github.com/kynoproj/kynomesh
Doc: https://kyno.sh
Blog: https://blog.kyno.sh

What it is

Kynomesh lets you declare a group of cooperating agents as one Kubernetes resource, an AgentSet, and takes care of running them and wiring them together over A2A. Each agent runs in its own pods with an injected broker sidecar that handles A2A transport. Your agent code stays an ordinary A2A agent.

apiVersion: kynomesh.kyno.sh/v1alpha1
kind: AgentSet
metadata:
  name: travel
spec:
  pattern: Supervisor
  entry: supervisor
  agents:
    - name: supervisor
      container:
        image: travel:latest
        args: ["--role", "supervisor"]
    - name: flights
      container:
        image: travel:latest
        args: ["--role", "flights"]
    - name: hotels
      container:
        image: travel:latest
        args: ["--role", "hotels"]

A few things it does:

• Pattern-based peer discovery. You pick a pattern (Supervisor, Handoff or Sequential) and an entry agent, and Kynomesh works out who can call whom. Agents call peers by name, with no URLs in code.
• AgentCards drive behaviour. A supervisor can discover its workers at startup and build its tools from their AgentCards. When a peer's card changes, Kynomesh can restart only the agents still holding the stale copy (we call this drift reload).
• Any framework, any language. Agents only see each other's cards and A2A endpoints. We have Python and Go SDKs for now, and examples with LangGraph and the Claude Agent SDK, including one AgentSet that mixes both.
• External agents. An AgentSet can reference an agent that lives in another AgentSet, or at any URL, and call it like any other peer.
• Operations. Autoscaling per agent, rate limiting (max in-flight requests), and zero-downtime rolling updates with request draining.

Try it

• Quick start: https://github.com/kynoproj/kynomesh/blob/main/docs/quick-start.md
• Tutorials (single agent, supervisor, dynamic peers, mixed frameworks, external agents): https://github.com/kydocs/tutorials
• Runnable examples: https://github.com/kynoproj/kynomesh-examples - SDKs: https://github.com/kynhttps://github.com/kynoproj/kynomesh-go

Where it is today

It's early and under active development, and minor versions can contain breaking changes. We'd like to hear frosystems before we settle more of the design.

Feedback we'd value

• Patterns. Do Supervisor, Handoff and Sequential cover how you connect agents? What topologies are yo "handoff" mean precisely?
• Discovery and AgentCards. We discover peers and build tools from their cards, and treat a changed card as somethow you use cards? What wouldyou want from the spec or from tooling here?
• Gaps. What did you expes that isn't there?

Issues, discussions and PRs - I'm happy to answer questions here.

Thanks!

[whynowy]

BTW - I will speak at KubeCon Salt Lake City, Co-located Events, [Agentics Day: MCP + Agents], to talk about Orchestrating, Discovering, and Autoscaling Distributed Multi-Agent AI Systems with Kynomesh, hope we can meet there.

https://events.linuxfoundation.org/kubecon-cloudnativecon-north-america/co-located-events/cncf-hosted-co-located-schedule/?id=1267474

[kaspermuutra-dotcom]

Drift reload is a great idea. One gap it exposes: when a peer's card changes, the supervisor rebuilds its tools from the new card and trusts it immediately. A hook that verifies the new card's skills behave as declared before the reload completes (or at least flags the change) would stop a bad deploy from propagating through the whole AgentSet. Is there a place in the reload path for that kind of check?

Kasper

[whynowy]

Hi @kaspermuutra-dotcom,

Sorry for the late response. Yes, today, the drift reload feature has a gate (N consecutive checks getting same result) to see if the remote A2A server is stable with the new capability. Would like to understand more your suggestion of using a hook, or flags, appreciate if you could give more detail.

Thanks