Repolode
kubeai-project

kubeai-project/kubeai

Un operador de Kubernetes que despliega y escala automáticamente modelos de LLM, embeddings, reranking y transcripción de voz mediante una API compatible con OpenAI.

Estrellas
1,289
Forks
144
Issues abiertos
97
Último commit
hace 4 días

¿Qué es?

KubeAI es un operador de inferencia de IA para Kubernetes que despliega y escala modelos de machine learning, como LLM, modelos de embeddings, rerankers y modelos de transcripción de voz. Gestiona servidores de backend como vLLM, Ollama, FasterWhisper e Infinity en Pods de Kubernetes, y se encarga de descargar modelos, montar volúmenes y cargar adaptadores LoRA de forma dinámica mediante un recurso personalizado Model.

El proyecto incluye un proxy que expone endpoints compatibles con OpenAI, como chat completions, embeddings, rerank y transcripciones de audio, para que se puedan usar bibliotecas cliente de OpenAI existentes configurándolas para que se conecten a este proxy. El proxy utiliza balanceo de carga que tiene en cuenta los prefijos para mejorar el aprovechamiento de la caché KV entre réplicas de vLLM, pone las solicitudes en cola mientras un modelo escala desde cero réplicas y las reintenta cuando falla el backend.

KubeAI se instala con Helm y está diseñado para funcionar sin dependencias como Istio, Knative o un adaptador de métricas de Prometheus. Incluye un catálogo de modelos predefinidos y es compatible con hardware CPU, GPU y TPU.

Funciones clave

  • 01Despliega servidores vLLM, Ollama, FasterWhisper e Infinity como Pods de Kubernetes.
  • 02Escala las réplicas de los modelos desde cero según la demanda.
  • 03Expone endpoints compatibles con OpenAI para chat, embeddings, rerank y transcripción.
  • 04Utiliza balanceo de carga que tiene en cuenta los prefijos para mejorar el aprovechamiento de la caché KV de vLLM.
  • 05Automatiza la descarga de modelos y el montaje de volúmenes, y gestiona adaptadores LoRA.

Casos de uso

  • Alojar LLM de pesos abiertos en el clúster de Kubernetes de una empresa mediante una API al estilo de OpenAI.
  • Ejecutar servicios de transcripción de voz que reducen su escala cuando están inactivos.
  • Ofrecer modelos de embeddings y reranking para canalizaciones de búsqueda o recuperación de información.

Inicio rápido

  1. 1

    Crea un clúster local de Kubernetes

    kind create cluster
  2. 2

    Añade el repositorio de Helm de KubeAI

    helm repo add kubeai https://www.kubeai.org
  3. 3

    Instala KubeAI y espera a que los componentes estén listos

    helm install kubeai kubeai/kubeai --wait --timeout 10m
  4. 4

    Instala los modelos predefinidos mediante un archivo values (consulta el YAML en el README)

Antes de usarlo

  • Requiere un clúster de Kubernetes en ejecución; no es una herramienta independiente.
  • La configuración local mediante Podman para kind requiere al menos 6 GB de memoria en la máquina.

En colecciones

Temas

Preguntas frecuentes

¿Qué es kubeai?
Un operador de Kubernetes que despliega y escala automáticamente modelos de LLM, embeddings, reranking y transcripción de voz mediante una API compatible con OpenAI. KubeAI es un operador de inferencia de IA para Kubernetes que despliega y escala modelos de machine learning, como LLM, modelos de embeddings, rerankers y modelos de transcripción de voz. Gestiona servidores de backend como vLLM, Ollama, FasterWhisper e Infinity en Pods de Kubernetes, y se encarga de descargar modelos, montar volúmenes y cargar adaptadores LoRA de forma dinámica mediante un recurso personalizado Model.
¿kubeai es gratuito? ¿Qué licencia tiene?
kubeai es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿kubeai sigue mantenido?
Mantenimiento activo. El último commit de kubeai fue el 3 nov 2026.
¿Para qué puedo usar kubeai?
Alojar LLM de pesos abiertos en el clúster de Kubernetes de una empresa mediante una API al estilo de OpenAI. Ejecutar servicios de transcripción de voz que reducen su escala cuando están inactivos. Ofrecer modelos de embeddings y reranking para canalizaciones de búsqueda o recuperación de información.
¿Cómo se instala kubeai?
Crea un clúster local de Kubernetes: kind create cluster Añade el repositorio de Helm de KubeAI: helm repo add kubeai https://www.kubeai.org Instala KubeAI y espera a que los componentes estén listos: helm install kubeai kubeai/kubeai --wait --timeout 10m Instala los modelos predefinidos mediante un archivo values (consulta el YAML en el README)
¿Dónde consigo kubeai?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/kubeai-project/kubeai

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados