Repolode
google

google/ax

AX es un orquestador declarativo de código abierto para ejecutar grandes cantidades de tareas de agentes autónomos en sandbox dentro de un clúster de Kubernetes.

Estrellas
13,963
Forks
723
Issues abiertos
91
Último commit
hace 18 horas

¿Qué es?

AX permite describir una tarea de agentes en YAML mediante tres tipos de recursos: Task, Workspace y Model. Una Task se ejecuta en un sandbox aislado con límites de CPU y memoria; un Workspace deja preconfigurados los repositorios Git, los servidores MCP y los paquetes de skills para que los agentes dispongan de sus herramientas desde el inicio; y un Model configura qué LLM usa la plataforma, con credenciales obtenidas de un secret de Kubernetes. Los manifiestos usan la API ax.io/v1alpha1 y se aplican con la CLI ax, que sigue el estilo de verbos de kubectl.

AX se ejecuta sobre Agent Substrate para ofrecer ejecución aislada en sandbox. Permite suspender una tarea inactiva guardando un checkpoint y reanudarla más adelante, además de abrir una shell en un sandbox en ejecución con ax ssh para depurar. La CLI se comunica con el plano de control mediante gRPC y obtiene el clúster del contexto activo de kubectl.

El proyecto está en pleno desarrollo, por lo que sus conceptos, protocolos y API pueden cambiar con actualizaciones que introduzcan incompatibilidades antes de una versión estable. Para instalarlo, se necesita un clúster de Kubernetes que ya tenga Agent Substrate en ejecución.

Funciones clave

  • 01Manifiestos declarativos de Task, Workspace y Model que se aplican con un solo comando.
  • 02Ejecución de tareas en sandbox con límites de CPU y memoria.
  • 03Suspensión y reanudación de tareas de agentes en ejecución mediante checkpoints.
  • 04Acceso interactivo a una shell dentro de un sandbox en ejecución con ax ssh.
  • 05CLI al estilo de kubectl que usa el contexto activo de Kubernetes.

Casos de uso

  • Ejecutar muchas cargas de trabajo de agentes autónomos o no confiables aisladas en un clúster de Kubernetes.
  • Preconfigurar repositorios Git y servidores de herramientas MCP para que los agentes tengan el contexto necesario desde el inicio.
  • Pausar agentes inactivos de larga duración y reanudarlos más adelante sin perder su estado.

Inicio rápido

  1. 1

    Instala Agent Substrate en tu clúster de Kubernetes y verifica su servicio de API

    kubectl get svc api -n ate-system
  2. 2

    Instala la CLI de ax

    go install github.com/google/ax/cmd/ax@latest
  3. 3

    Despliega el plano de control de AX con tu registro de contenedores

    make deploy AX_IMAGE_REPO=<your-registry>
  4. 4

    Aplica la tarea de ejemplo y comprueba su estado

    ax apply -f examples/task.yaml

Antes de usarlo

  • AX requiere un clúster de Kubernetes con Agent Substrate instalado previamente.
  • El proyecto está en pleno desarrollo y es probable que introduzca cambios importantes que rompan la compatibilidad antes de una versión estable.

Temas

Preguntas frecuentes

¿Qué es ax?
AX es un orquestador declarativo de código abierto para ejecutar grandes cantidades de tareas de agentes autónomos en sandbox dentro de un clúster de Kubernetes. AX permite describir una tarea de agentes en YAML mediante tres tipos de recursos: Task, Workspace y Model. Una Task se ejecuta en un sandbox aislado con límites de CPU y memoria; un Workspace deja preconfigurados los repositorios Git, los servidores MCP y los paquetes de skills para que los agentes dispongan de sus herramientas desde el inicio; y un Model configura qué LLM usa la plataforma, con credenciales obtenidas de un secret de Kubernetes. Los manifiestos usan la API ax.io/v1alpha1 y se aplican con la CLI ax, que sigue el estilo de verbos de kubectl.
¿ax es gratuito? ¿Qué licencia tiene?
ax es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿ax sigue mantenido?
Mantenimiento activo. El último commit de ax fue el 18 oct 2026.
¿Para qué puedo usar ax?
Ejecutar muchas cargas de trabajo de agentes autónomos o no confiables aisladas en un clúster de Kubernetes. Preconfigurar repositorios Git y servidores de herramientas MCP para que los agentes tengan el contexto necesario desde el inicio. Pausar agentes inactivos de larga duración y reanudarlos más adelante sin perder su estado.
¿Cómo se instala ax?
Instala Agent Substrate en tu clúster de Kubernetes y verifica su servicio de API: kubectl get svc api -n ate-system Instala la CLI de ax: go install github.com/google/ax/cmd/ax@latest Despliega el plano de control de AX con tu registro de contenedores: make deploy AX_IMAGE_REPO=<your-registry> Aplica la tarea de ejemplo y comprueba su estado: ax apply -f examples/task.yaml
¿Dónde consigo ax?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/google/ax

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

Proyectos relacionados