kagent

Core Principles

• Kubernetes Native: Manage agent and tool configuration through Kubernetes APIs and familiar kubectl workflows.
• Extensible: Add custom tools, skills, and runtimes to connect agents to your own systems.
• Flexible: Choose the models and runtimes that fit your workload, and reuse agent templates across compatible harnesses.
• Observable: Trace agent, model, and tool execution with OpenTelemetry and your existing observability stack.
• Declarative: Define agents in YAML, keep configuration in version control, and deploy through GitOps workflows.
• Testable: Test agents through their public APIs and use task history and traces to diagnose failures.

Architecture

flowchart TD
    UI[UI] --> CONTROLLER[kagent Controller]
    CLI[CLI] --> CONTROLLER
    CONFIG[Kubernetes resources] --> CONTROLLER
    CONTROLLER --> DB[(PostgreSQL)]
    CONTROLLER --> SUBSTRATE[Substrate]
    SUBSTRATE --> RUNTIMES[Agent runtimes]
    CONTROLLER -->|A2A| RUNTIMES

Kagent brings together the following components:

• Controller: The controller watches kagent custom resources, prepares agents to run, and manages their sessions. It exposes gRPC, A2A, and MCP APIs for clients to interact with agents.
• UI: The UI is a web UI that allows you to manage agents and tools and chat with your agents.
• Agent Runtimes: Agents run using the Go or Python ADK, Codex, Claude, or a custom runtime, selected by their Harness.
• Substrate: Substrate runs the agents and manages their lifecycle, including suspension, resumption, and snapshots.
• PostgreSQL: PostgreSQL stores sessions, tasks, and conversation history so they persist independently of the running agents.
• CLI: The CLI is a command-line tool that allows you to manage agents and tools and interact with your agents.

For more details on the v1 architecture, including resource definitions and how agents run, see the architecture guide.

Get Involved

We welcome contributions! Contributors are expected to respect the kagent Code of Conduct

There are many ways to get involved:

• 🐛 Report bugs and issues
• 💡 Suggest new features
• 📖 Improve documentation
• 🔧 Submit pull requests
• ⭐ Star the repository
• 💬 Help others in Discord
• 💬 Join the kagent community meetings
• 🤝 Share tips in the CNCF #kagent slack channel
• 🔒 Report security concerns

Roadmap

kagent is currently in active development. You can check out the full roadmap in the project Kanban board here.

Local development

For instructions on running Kagent locally, see DEVELOPMENT.md.

Contributors

Thanks to all contributors who are helping to make kagent better.

Star History

Reference

License

This project is licensed under the Apache 2.0 License.