Home

Deploy AI Agents on Kubernetes

The simplest way to deploy, manage, and scale AI agents in your Kubernetes cluster with declarative YAML configurations

🚀 Get Started Now View on GitHub

✨ Why Choose KubeAgentic?

🤖

Multi-Provider Support

OpenAI, Anthropic (Claude), Google (Gemini), and self-hosted vLLM models - all in one platform

📝

Declarative Configuration

Standard Kubernetes Custom Resources (CRDs) for easy management and GitOps workflows

🔄

Auto-Scaling

Automatic scaling based on demand and resource usage with Kubernetes HPA integration

🔒

Secure by Default

API keys managed with Kubernetes Secrets and RBAC for enterprise-grade security

📊

Built-in Monitoring

Real-time health checks, metrics, and status reporting with Prometheus integration

🛠️

Tool Integration

Extend agents with custom tools, APIs, and services for complex workflows

🚀 Quick Start

# Install KubeAgentic (uses optimized Docker images)
kubectl apply -f https://raw.githubusercontent.com/KubeAgentic-Community/KubeAgentic/main/deploy/all.yaml

# Create API key secret
kubectl create secret generic openai-secret \
  --from-literal=api-key='your-openai-api-key'

# Deploy your first agent
kubectl apply -f https://raw.githubusercontent.com/KubeAgentic-Community/KubeAgentic/main/examples/openai-agent.yaml

# Interact with your agent
kubectl port-forward service/my-assistant-service 8080:80
curl -X POST http://localhost:8080/chat \
  -H "Content-Type: application/json" \
  -d '{"message": "Hello! How can you help me?"}'
    

View All Examples

🐳 Optimized Docker Images

⚡

Operator

sudeshmu/kubeagentic:operator-latest

108MB - Highly Optimized

Red Hat UBI Micro base image

🚀

Agent Runtime

sudeshmu/kubeagentic:agent-latest

625MB - 66% Smaller!

Red Hat UBI Minimal + Python optimizations

# Pull optimized images directly from Docker Hub
docker pull sudeshmu/kubeagentic:operator-latest  # 108MB
docker pull sudeshmu/kubeagentic:agent-latest     # 625MB

# Verify image sizes
docker images sudeshmu/kubeagentic
    

✨ Multi-stage builds • Red Hat UBI security • Non-root execution • Multi-architecture

🐳 View on Docker Hub

🏗️ How It Works

☸️

Kubernetes Cluster

Your existing K8s infrastructure

→

🤖

KubeAgentic Operator

Deploy & manage AI agents

→

🧠

AI Models

OpenAI, Claude, Gemini, vLLM

→

📈

Auto-Scaling

Monitor & scale automatically

📚 Documentation

⚡

Direct Framework

Simple, fast API calls for basic interactions

Learn More →

🔗

LangGraph Framework

Complex workflows with multi-step reasoning

Learn More →

🔧

API Reference

Detailed API specification and examples

View Docs →

💡

Examples

Real-world usage examples and templates

View Examples →

🎯 Use Cases

🎧

Customer Support

Deploy scalable support bots that can handle multiple conversations simultaneously with context awareness

🔍

Code Review

Automated code analysis and feedback for improved code quality, security, and best practices

📚

Knowledge Management

Internal Q&A assistants for company documentation, procedures, and knowledge base queries

✍️

Content Generation

AI-powered content creation for marketing, documentation, and automated report generation

🤝 Community & Support

GitHub

Star us on GitHub and contribute

View Repository →

Issues

Report bugs and request features

Report Issue →

Discussions

Join the community discussions

Join Discussion →

Contact

Get in touch with us directly

contact@kubeagentic.com

Licensed under the Apache License 2.0. See LICENSE for details.