README
¶
Kynomesh
Welcome to Kynomesh! A Kubernetes-native platform for orchestrating distributed multi-agent systems. Kynomesh lets you declare a group of cooperating 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, Node.js, Rust, and more. Managed and external agents: An AgentSet can seamlessly combine agents running inside the cluster with external HTTP-based agents, providing a unified interface to callers.
- 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.
Resources
License
Apache License Version 2.0, see LICENSE.
Directories
¶
| Path | Synopsis |
|---|---|
|
hack
|
|
|
crdgen
command
|
|
|
gen-openapi-spec
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/scaling
Package scaling implements the AgentDeploy autoscaler.
|
Package scaling implements the AgentDeploy autoscaler. |
|
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. |
|
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
|
|
Click to show internal directories.
Click to hide internal directories.