Kagenti is a cloud-native middleware providing a framework-neutral, scalable and secure platform for deploying and orchestrating AI agents through a standardized REST API.
| Included Services: | |
|---|---|
| - Authentication and Authorization - Trusted identity - Deployment - Configuration - Scaling - Fault-tolerance - Checkpointing - Discovery of agents and tools - Persistence |
Kagenti provides a set of components and assets that make it easier to manage AI agents and tools and integrate their fine-grained authorization into modern cloud-native environments.
| Component | Description |
|---|---|
| Kagenti UI | Dashboard for deploying agents/tools, interactive testing, and monitoring |
| Identity & Auth Bridge | Identity pattern assets that capture common authorization scenarios and provide reusable building blocks for implementing consistent authorization across services |
| Agent Lifecycle Operator | Kubernetes admission webhook for building agents from source, managing lifecycle, and coordinating platform services |
| MCP Gateway | Unified gateway for Model Context Protocol (MCP) servers and tools. It acts as the entry point for policy enforcement, handling requests and routing them through the appropriate authorization patterns |
┌───────────────────────────────────────────────────────────────────────┐
│ Kubernetes Cluster │
├───────────────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────────────────────────────────────────────────────────┐ │
│ │ kagenti-system Namespace │ │
│ │ ┌────────────┐ ┌────────────┐ ┌────────────┐ ┌────────────┐ │ │
│ │ │ Kagenti UI │ │ Agent │ │ Ingress │ │ Kiali │ │ │
│ │ │ │ │ Lifecycle │ │ Gateway │ │ │ │ │
│ │ │ │ │ Operator │ │ │ │ │ │ │
│ │ └────────────┘ └────────────┘ └────────────┘ └────────────┘ │ │
│ └─────────────────────────────────────────────────────────────────┘ │
│ │
│ ┌──────────────────────────────────────────────────────────────────┐ │
│ │ Workload Namespaces (team1, team2, ...) │ │
│ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ │
│ │ │ A2A Agents │ │ MCP Tools │ │ Custom │ │ │
│ │ │ (LangGraph, │ │ (weather, │ │ Workloads │ │ │
│ │ │ CrewAI, │ │ slack, │ │ │ │ │
│ │ │ AG2...) │ │ fetch...) │ │ │ │ │
│ │ └──────────────┘ └──────────────┘ └──────────────┘ │ │
│ └──────────────────────────────────────────────────────────────────┘ │
│ │
│ ┌────────────────────┐ ┌────────────────────┐ |
│ │ gateway-system │ │ mcp-system │ │
│ │ ┌──────────────┐ │ │ ┌──────────────┐ │ │
│ │ │ MCP Gateway │ │ │ │ MCP Broker │ │ │
│ │ │ (Envoy) │ │ │ │ Controller │ │ │
│ │ └──────────────┘ │ │ └──────────────┘ │ │
│ └────────────────────┘ └────────────────────┘ │
│ │
│ ┌────────────────┐ ┌────────────────┐ ┌────────────────────┐ │
│ │ SPIRE │ │ IAM │ │ Istio Ambient │ │
│ │ (Identity) │ │(e.g. Keycloak) | │ (Service Mesh) │ │
│ └────────────────┘ └────────────────┘ └────────────────────┘ │
│ │
└───────────────────────────────────────────────────────────────────────┘- Python ≥3.9 with uv installed
- Docker Desktop, Rancher Desktop, or Podman (16GB RAM, 4 cores recommended)
- Kind, kubectl, Helm
- Ollama for local LLM inference
The Ansible-based Helm installer is now the recommended and default installer for Kagenti. The legacy kagenti-installer (the uv-based Kind installer) is deprecated and will be removed in a future release. See installer/DEPRECATION.md for migration notes and timelines.
Quick Install (recommended — Ansible-based):
# Clone the repository
git clone https://github.com/kagenti/kagenti.git
cd kagenti
# Copy and configure secrets
cp deployments/envs/secret_values.yaml.example deployments/envs/.secret_values.yaml
# Edit deployments/envs/.secret_values.yaml with your values
# Run the Ansible-based installer (default)
deployments/ansible/run-install.sh --env devFor local Kind development the legacy kagenti-installer remains available but is deprecated:
# Configure environment for legacy installer (deprecated)
cp kagenti/installer/app/.env_template kagenti/installer/app/.env
# Edit .env with your GITHUB_USER, GITHUB_TOKEN, and optionally OPENAI_API_KEY
cd kagenti/installer
uv run kagenti-installerUse deployments/ansible/run-install.sh --help (recommended) or uv run kagenti-installer --help (deprecated) for options. For more detailed installation instructions including OpenShift refer to Installation Guide.
open http://kagenti-ui.localtest.me:8080
# Login: admin / adminFrom the UI you can:
- Import and deploy A2A agents from any framework
- Deploy MCP tools directly from source
- Test agents interactively
- Monitor traces and network traffic
| Topic | Link |
|---|---|
| Installation | Installation Guide (Kind & OpenShift) |
| Components | Component Details |
| Demos & Tutorials | Demo Documentation |
| Import Your Own Agent | New Agent Guide |
| Architecture Details | Technical Details |
| Identity, Security, and Auth Bridge | Identity and Auth Bridge |
| Developer Guide | Contributing |
| Troubleshooting | Troubleshooting Guide |
| Blog Posts | Kagenti Blog |
- A2A (Agent-to-Agent) — Standard protocol for agent communication
- MCP (Model Context Protocol) — Protocol for tool/server integration
We welcome contributions! See CONTRIBUTING.md for guidelines.
This QR Code links to http://kagenti.io