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.