kagent is a Kubernetes native framework for building AI agents. Kubernetes is the most popular orchestration platform for running workloads, and kagent makes it easy to build, deploy and manage AI agents in Kubernetes. The kagent framework is designed to be easy to understand and use, and to provide a flexible and powerful way to build and manage AI agents.

  Getting Started


  Technical Details


  Get Involved


  Reference

Getting started

• Quick Start (https://kagent.dev/docs/kagent/getting-started/quickstart)
• Installation guide (https://kagent.dev/docs/kagent/introduction/installation)

Technical Details

Core Concepts

• Agents: Agents are the main building block of kagent. They are a system prompt, a set of tools and agents, and an LLM configuration represented with a Kubernetes custom resource called "Agent".
• LLM Providers: Kagent supports multiple LLM providers, including OpenAI (https://kagent.dev/docs/kagent/supported-providers/openai), Azure OpenAI (https://kagent.dev/docs/kagent/supported-providers/azure-openai), Anthropic (https://kagent.dev/docs/kagent/supported-providers/anthropic), Google Vertex AI (https://kagent.dev/docs/kagent/supported-providers/google-vertexai), Ollama (https://kagent.dev/docs/kagent/supported-providers/ollama) and any other custom providers and models (https://kagent.dev/docs/kagent/supported-providers/custom-models) accessible via AI gateways. Providers are represented by the ModelConfig resource.
• MCP Tools: Agents can connect to any MCP server that provides tools. Kagent comes with an MCP server with tools for Kubernetes, Istio, Helm, Argo, Prometheus, Grafana, Cilium, and others. All tools are Kubernetes custom resources (ToolServers) and can be used by multiple agents.
• Observability: Kagent supports OpenTelemetry tracing (https://kagent.dev/docs/kagent/getting-started/tracing), which allows you to monitor what's happening with your agents and tools.

Core Principles

• Kubernetes Native: Kagent is designed to be easy to understand and use, and to provide a flexible and powerful way to build and manage AI agents.
• Extensible: Kagent is designed to be extensible, so you can add your own agents and tools.
• Flexible: Kagent is designed to be flexible, to suit any AI agent use case.
• Observable: Kagent is designed to be observable, so you can monitor the agents and tools using all common monitoring frameworks.
• Declarative: Kagent is designed to be declarative, so you can define the agents and tools in a YAML file.
• Testable: Kagent is designed to be tested and debugged easily. This is especially important for AI agent applications.

Architecture

The kagent framework is designed to be easy to understand and use, and to provide a flexible and powerful way to build and manage AI agents.

Kagent has 4 core components:

• Controller: The controller is a Kubernetes controller that watches the kagent custom resources and creates the necessary resources to run the agents.
• UI: The UI is a web UI that allows you to manage the agents and tools.
• Engine: The engine runs your agents using ADK (https://google.github.io/adk-docs/).
• CLI: The CLI is a command-line tool that allows you to manage the agents and tools.

Get Involved

We welcome contributions! Contributors are expected to respect the kagent Code of Conduct (https://github.com/kagent-dev/community/blob/main/CODE-OF-CONDUCT.md)

There are many ways to get involved:

• 🐛 Report bugs and issues (https://github.com/kagent-dev/kagent/issues/)
• 💡 Suggest new features (https://github.com/kagent-dev/kagent/issues/)
• 📖 Improve documentation (https://github.com/kagent-dev/website/)
• 🔧 Submit pull requests
• ⭐ Star the repository
• 💬 Help others in Discord (https://discord.gg/Fu3k65f2k3)
• 💬 Join the kagent community meetings (https://calendar.google.com/calendar/u/0?cid=Y183OTI0OTdhNGU1N2NiNzVhNzE0Mjg0NWFkMzVkNTVmMTkxYTAwOWVhN2ZiN2E3ZTc5NDA5Yjk5NGJhOTRhMmVhQGdyb3VwLmNhbGVuZGFyLmdvb2dsZS5jb20)
• 🤝 Share tips in the CNCF #kagent slack channel (https://cloud-native.slack.com/archives/C08ETST0076)
• 🔒 Report security concerns

Roadmap

kagent is currently in active development. You can check out the full roadmap in the project Kanban board here (https://github.com/orgs/kagent-dev/projects/3).

Local development

For instructions on how to run everything locally, see the DEVELOPMENT.md file.

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.

kagent is a Cloud Native Computing Foundation project.