๐Ÿง  NeuroNetes

Kubernetes, reimagined for AI agents

Deploy and scale LLM-based AI agents as easily as web services. NeuroNetes handles GPU scheduling, cold starts, session management, and token-aware autoscalingโ€”so you can focus on building.

20x
Faster Scale-Up
85%
GPU Utilization
40%
Cost Reduction
<300ms
Time to First Token

The Problem with AI Agents on Kubernetes

You've built an amazing AI agent. Now you need to deploy it. Here's what you're facing:

๐Ÿ˜ค Cold Start Nightmares

Loading a 70B model takes 45+ seconds. Your users aren't waiting that long. Scaling from zero means losing customers.

๐Ÿ’ธ GPU Bills Out of Control

GPUs sitting at 50% utilization while you pay full price. No easy way to share expensive hardware across workloads.

๐Ÿ”ง DIY Everything

Session affinity? Build it yourself. Token-aware scaling? Write custom metrics. Model versioning? Good luck.

The Solution: NeuroNetes

NeuroNetes extends Kubernetes with everything you need to run AI agents in production. Define your models, set your SLOs, and let NeuroNetes handle the rest.

๐Ÿš€

Instant Scale-Up

Warm pools keep models preloaded. Go from zero to serving in 2.3 seconds instead of 45+. Snapshot/restore makes scaling feel instant.

๐ŸŽฎ

Smart GPU Scheduling

Topology-aware bin-packing, MIG partitioning, and gang scheduling for multi-GPU jobs. Get 85%+ GPU utilization without manual tuning.

๐ŸŽฏ

Token-Aware Autoscaling

Scale on what matters: tokens/sec, TTFT, queue depth, context length. Not just CPU and memory. Your agents scale based on actual demand.

๐Ÿ’ฌ

Session Affinity Built-In

Conversations stick to the same backend. Graceful handoff during scaling. No lost context, ever.

๐Ÿ“ฆ

Models as Kubernetes Objects

First-class CRDs for models with versioning, quantization profiles, and sharding. Declarative model management finally.

๐Ÿ“Š

60+ Specialized Metrics

TTFT, tokens/sec, tool-call latency, cost per request. Pre-built Grafana dashboards included.

๐Ÿ’ฐ

Cost-Aware Scheduling

Balance SLOs, $/token, and carbon footprint. Spot instances with guardrails. 40% average cost reduction.

๐Ÿ›ก๏ธ

Built-In Guardrails

Tool permissions, rate limits, PII detection, and audit trails. Security by default.

๐Ÿ”„

Queue-Native Design

NATS, Kafka, SQS integration out of the box. Scale on queue depth. Message-driven architecture that works.

How It Works

1

Define Your Model

Specify weights, quantization, and sharding with a simple YAML. NeuroNetes handles the rest.

2

Create an AgentClass

Set your SLOs, guardrails, and tool permissions. This is your agent's blueprint.

3

Deploy an AgentPool

Set replica limits and let NeuroNetes autoscale based on real demand.

# That's it. Your agent is now production-ready.
kubectl apply -f model.yaml
kubectl apply -f agentclass.yaml
kubectl apply -f agentpool.yaml

# Check status
kubectl get agentpools
# NAME         READY   REPLICAS   TTFT-P95
# chat-pool    True    5          142ms

Architecture

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚                    Control Plane                             โ”‚
โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
โ”‚  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”            โ”‚
โ”‚  โ”‚   Model    โ”‚  โ”‚ AgentClass โ”‚  โ”‚ AgentPool  โ”‚  CRDs      โ”‚
โ”‚  โ”‚ Controller โ”‚  โ”‚ Controller โ”‚  โ”‚ Controller โ”‚            โ”‚
โ”‚  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜            โ”‚
โ”‚                                                               โ”‚
โ”‚  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”            โ”‚
โ”‚  โ”‚   Token    โ”‚  โ”‚    GPU     โ”‚  โ”‚ Cost/SLA   โ”‚ Schedulers โ”‚
โ”‚  โ”‚   HPA      โ”‚  โ”‚ Topology   โ”‚  โ”‚  Policy    โ”‚            โ”‚
โ”‚  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜            โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                            โ”‚
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚                      Data Plane                              โ”‚
โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
โ”‚  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”            โ”‚
โ”‚  โ”‚  Sticky    โ”‚  โ”‚  Stream    โ”‚  โ”‚  Message   โ”‚            โ”‚
โ”‚  โ”‚  Session   โ”‚  โ”‚  Aware     โ”‚  โ”‚  Broker    โ”‚            โ”‚
โ”‚  โ”‚  Router    โ”‚  โ”‚  Ingress   โ”‚  โ”‚  Class     โ”‚            โ”‚
โ”‚  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜            โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                            โ”‚
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚                    Runtime Layer                             โ”‚
โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
โ”‚  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”            โ”‚
โ”‚  โ”‚  Warm Pool โ”‚  โ”‚ Snapshot/  โ”‚  โ”‚  Sidecar   โ”‚            โ”‚
โ”‚  โ”‚ Controller โ”‚  โ”‚  Restore   โ”‚  โ”‚  Caches    โ”‚            โ”‚
โ”‚  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜            โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                

Examples & Use Cases

๐Ÿ’ฌ Simple Chat Agent

Deploy a conversational AI agent with session management, HTTP endpoints, and cost optimization. Perfect for customer support or virtual assistants.

kubectl apply -f - <
                    
View Full Example โ†’

๐Ÿ”ง Code Assistant

RAG-powered code assistant with multiple tools, queue-based task processing, and session-based state management.

toolPermissions:
  - name: code-search
    rateLimit: 100/min
  - name: file-read
    rateLimit: 50/min
guardrails:
  - type: pii-detection
    action: redact
slo:
  ttft: 500ms
  tokensPerSecond: 50
View Full Example โ†’

๐Ÿ“š RAG Pipeline

Complete retrieval-augmented generation setup with vector store, embedding model, and data locality optimization.

scheduling:
  dataLocality:
    vectorStoreAffinity:
      - weaviate
    cacheAffinity:
      - redis
  costOptimization:
    enabled: true
    spotEnabled: true
View Full Example โ†’

Performance & Metrics

<300ms
Time to First Token (P95)
60+
Specialized Metrics
95.7%
Test Coverage
10x
Faster Scale-from-Zero

Key Metric Categories

UX & Quality

  • TTFT P95 (Time to First Token)
  • End-to-end latency
  • RTF (Realtime Factor) ratio
  • CSAT scores

Token Economics

  • Tokens per second throughput
  • Cost per 1K tokens
  • Context length utilization
  • Queue depth metrics

GPU Efficiency

  • GPU utilization percentage
  • VRAM usage patterns
  • MIG slice efficiency
  • Tensor core utilization

Tool Performance

  • Tool call latency P95
  • Tool success rate
  • RAG retrieval time
  • Cache hit ratio

Grafana Dashboards

Pre-built dashboards for complete observability

# Import ready-to-use Grafana dashboard
kubectl create configmap neuronetes-dashboard \
  --from-file=config/grafana/neuronetes-dashboard.json \
  -n monitoring

# Access at http://localhost:3000/d/neuronetes-agents
# Default credentials: admin/admin

Quick Start

Prerequisites

Choose Your Platform

AWS (EKS) Installation

Deploy NeuroNetes on Amazon EKS with GPU-enabled EC2 instances

1. Create EKS Cluster

# Configure variables
export CLUSTER_NAME=neuronetes-prod
export REGION=us-west-2
export K8S_VERSION=1.28

# Create cluster with GPU node groups
eksctl create cluster \
  --name $CLUSTER_NAME \
  --region $REGION \
  --version $K8S_VERSION \
  --node-type m5.xlarge \
  --nodes 2 \
  --nodes-min 2 \
  --nodes-max 5 \
  --managed \
  --with-oidc

# Add GPU node group (P4d instances with A100 GPUs)
eksctl create nodegroup \
  --cluster $CLUSTER_NAME \
  --region $REGION \
  --name gpu-nodes \
  --node-type p4d.24xlarge \
  --nodes 1 \
  --nodes-min 0 \
  --nodes-max 10 \
  --node-labels workload=ai-agent \
  --managed

2. Install GPU Operator

# Add NVIDIA Helm repository
helm repo add nvidia https://helm.ngc.nvidia.com/nvidia
helm repo update

# Install NVIDIA GPU Operator
helm install gpu-operator nvidia/gpu-operator \
  --namespace gpu-operator \
  --create-namespace \
  --set operator.defaultRuntime=containerd

3. Install NeuroNetes

# Install CRDs
kubectl apply -f https://raw.githubusercontent.com/Bowenislandsong/NeuroNetes/main/config/crd/

# Deploy controllers
kubectl apply -f https://raw.githubusercontent.com/Bowenislandsong/NeuroNetes/main/config/deploy/

# Verify installation
kubectl get pods -n neuronetes-system

๐Ÿ“– View Complete AWS Deployment Guide โ†’

How NeuroNetes Compares

See why teams are choosing NeuroNetes over building custom solutions or using generic ML serving platforms.

Feature Vanilla K8s KServe/Triton NeuroNetes
Cold Start Time 45+ seconds ~30 seconds 2.3 seconds โœ“
Token-Aware Scaling โŒ Manual โš ๏ธ Basic โœ“ Native
Session Affinity โŒ DIY โŒ Not designed for this โœ“ Built-in
GPU Utilization ~50% ~65% 85%+ โœ“
LLM-Specific Metrics โŒ None โš ๏ธ Limited 60+ metrics โœ“
Model CRDs โŒ โš ๏ธ Basic โœ“ Full lifecycle

Documentation

Ready to deploy your AI agents?

Join the growing community of teams shipping AI agents to production with NeuroNetes.

Get Started Free View Examples