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 |
|
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. |
|
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. |
|
reconciler/agentdeploy
Package agentdeploy implements the controller that reconciles AgentDeploy resources.
|
Package agentdeploy implements the controller that reconciles AgentDeploy resources. |
|
reconciler/agentset
Package agentset implements the controller that reconciles AgentSet resources and orchestrates the corresponding child AgentDeploy resources.
|
Package agentset implements the controller that reconciles AgentSet resources and orchestrates the corresponding child AgentDeploy resources. |
|
reconciler/cmd
Package cmd boots the kynomesh controller-manager: it constructs a controller-runtime manager, builds each reconciler as a standalone controller, wires probes and metrics, and blocks until the process is signalled to exit.
|
Package cmd boots the kynomesh controller-manager: it constructs a controller-runtime manager, builds each reconciler as a standalone controller, wires probes and metrics, and blocks until the process is signalled to exit. |
|
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. |
|
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.