kynomesh

module
v0.7.3 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 21, 2026 License: Apache-2.0

README

Kynomesh

Release Version slack GoDoc License CII Best Practices

Welcome to Kynomesh! A Kubernetes-native Agent Mesh platform for orchestrating distributed multi-agent systems. Kynomesh lets you declare a group of cooperating AI agents as a single Kubernetes resource and takes care of placement, peer discovery, and agent-to-agent (A2A) traffic - so you can focus on the agent logic instead of the wiring.

Each agent runs in its own dedicated set of pods, accompanied by an injected broker sidecar that manages A2A communication and transport. Kynomesh provides built-in autoscaling capabilities, automatically scaling agent workloads based on traffic patterns and system load. Agents are language-agnostic and can be implemented using any programming language.

Use Cases

  • Multi-agent LLM applications: a supervisor coordinating worker agents, or a swarm of specialized agents that hand off tasks to one another.
  • Sequential agent pipelines: each stage produces input for the next.
  • Heterogeneous agent fleets: combine agents written in different languages behind a single Kubernetes API.
  • Hybrid topologies: mix in-cluster managed agents with external agents reachable at a URL.

Key Features

  • Kubernetes-native: AgentSet is the primary custom resource in Kynomesh. If you're familiar with kubectl, you'll feel right at home managing and operating agent workloads.
  • Pattern-based peer discovery: Define a communication pattern (such as Supervisor, Handoff, or Sequential) along with an entry agent, and Kynomesh automatically derives and maintains peer relationships. No custom service-discovery logic is required in your agents.
  • Language agnostic: Build agents in any programming language, including Go, Python, and more.
  • Built-in autoscaling: Automatically scales agent workloads in response to traffic demand and system load, ensuring efficient resource utilization and high availability.
  • Zero-downtime rolling updates: Kynomesh orchestrates rolling deployments and graceful pod termination, enabling seamless upgrades with minimal disruption to ongoing traffic.
  • Rate limiting: Cap concurrent in-flight A2A requests, protecting agents (and their downstream dependencies) from overload.
  • Hybrid topologies with external agents: Combine in-cluster managed agents with external, HTTP-reachable agents behind a single Kubernetes API and unified peer discovery.
  • Automatic drift reload: Kynomesh detects when a peer agent's AgentCard changes and automatically restarts only the pods still holding a stale cached copy, so dependent agents pick up the change without a manual restart.

Resources

License

Apache License Version 2.0, see LICENSE.

Directories

Path Synopsis
cmd
hack
crdgen command
json-schema command
pkg
apis/kynomesh/v1alpha1
+kubebuilder:object:generate=true +groupName=kynomesh.kyno.sh +k8s:deepcopy-gen=package,register +k8s:openapi-gen=true
+kubebuilder:object:generate=true +groupName=kynomesh.kyno.sh +k8s:deepcopy-gen=package,register +k8s:openapi-gen=true
apis/proto/daemon
Package daemon is a reverse proxy.
Package daemon is a reverse proxy.
broker
Package broker hosts the kynomesh A2A broker service.
Package broker hosts the kynomesh A2A broker service.
broker/cmd
Package cmd boots the kynomesh broker.
Package cmd boots the kynomesh broker.
broker/ratelimit
Package ratelimit provides the broker's admission-control limiters.
Package ratelimit provides the broker's admission-control limiters.
client/clientset/versioned/fake
This package has the automatically generated fake clientset.
This package has the automatically generated fake clientset.
client/clientset/versioned/scheme
This package contains the scheme of the automatically generated clientset.
This package contains the scheme of the automatically generated clientset.
client/clientset/versioned/typed/kynomesh/v1alpha1
This package has the automatically generated typed clients.
This package has the automatically generated typed clients.
client/clientset/versioned/typed/kynomesh/v1alpha1/fake
Package fake has the automatically generated clients.
Package fake has the automatically generated clients.
daemon/client
Package client provides clients for the per-AgentSet metrics daemon.
Package client provides clients for the per-AgentSet metrics daemon.
daemon/server/cmd
Package cmd boots the per-AgentSet metrics daemon.
Package cmd boots the per-AgentSet metrics daemon.
daemon/server/scraper
Package scraper fetches Prometheus-format metrics.
Package scraper fetches Prometheus-format metrics.
daemon/server/service
Package server hosts the daemon's gRPC + REST API on a single TLS port (ALPN-dispatch like the broker) and its own /metrics surface on a separate TLS port.
Package server hosts the daemon's gRPC + REST API on a single TLS port (ALPN-dispatch like the broker) and its own /metrics surface on a separate TLS port.
reconciler/agentdeploy
Package agentdeploy implements the controller that reconciles AgentDeploy resources.
Package agentdeploy implements the controller that reconciles AgentDeploy resources.
reconciler/agentdeploy/driftwatch
Package driftwatch polls each drift-reload-enabled AgentDeploy's peer AgentCard drift state (reported by the per-AgentSet daemon, #214) and deletes exactly the pods still serving a stale cached peer AgentCard, so they restart and re-resolve.
Package driftwatch polls each drift-reload-enabled AgentDeploy's peer AgentCard drift state (reported by the per-AgentSet daemon, #214) and deletes exactly the pods still serving a stale cached peer AgentCard, so they restart and re-resolve.
reconciler/agentdeploy/scaling/decision
Package decision implements the AgentDeploy autoscaler's scaling math.
Package decision implements the AgentDeploy autoscaler's scaling math.
reconciler/agentset
Package agentset implements the controller that reconciles AgentSet resources and orchestrates the corresponding child resources.
Package agentset implements the controller that reconciles AgentSet resources and orchestrates the corresponding child resources.
reconciler/cmd
Package cmd boots the kynomesh controller-manager.
Package cmd boots the kynomesh controller-manager.
reconciler/validator
Package validator contains structural validation logic for kynomesh user-facing custom resources.
Package validator contains structural validation logic for kynomesh user-facing custom resources.
shared/discovery
Package discovery resolves the live pods of an AgentDeploy through the headless Service that the AgentDeploy reconciler maintains.
Package discovery resolves the live pods of an AgentDeploy through the headless Service that the AgentDeploy reconciler maintains.
webhook
Package webhook is used for the validating admission webhook.
Package webhook is used for the validating admission webhook.
Static health-check binary used for agent container's readiness/liveness exec probes.
Static health-check binary used for agent container's readiness/liveness exec probes.
test

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL