🎉 Join us at the MCP and Agents Community Party at KubeCon Atlanta on Nov 12
Documentation

kagent run#

Run an agent project locally with docker-compose and launch an interactive chat interface.

kagent run [project-directory] [flags]

Arguments:

  • project-directory - The directory containing the agent project (default: current directory)

Flags:

  • --project-dir - Project directory (default: current directory)

Global Flags:

  • --kagent-url - kagent URL (default: "http://localhost:8083")
  • --namespace, -n - Namespace (default: "kagent")
  • --output-format, -o - Output format (default: "table")
  • --timeout - Timeout duration (default: 300s)
  • --verbose, -v - Verbose output

About kagent run#

The kagent run command runs an agent project locally using docker-compose and launches an interactive chat session. This way, you can test and interact with your agent before deploying it to a Kubernetes cluster.

Example#

Run an agent project from the current directory:

kagent run

Run an agent project from a specific directory:

kagent run ./my-agent
Kagent Lab: Discover kagent and kmcp
Free, on‑demand lab: build custom AI agents with kagent and integrate tools via kmcp on Kubernetes.