Skip to main content

/adk-run - Run ADK Agents

Run Google ADK agents locally for development and testing.

Usage​

/adk-run <agent-path>            # Interactive CLI mode
/adk-run --web <agents-dir>      # Web UI mode
/adk-run --api <agents-dir>      # API server mode
/adk-run --list                  # List available agents

Examples​

Interactive CLI​

# Run single agent
/adk-run agents/my_agent

# With custom model
/adk-run agents/my_agent --model gemini-2.5-flash-preview
# Launch web interface
/adk-run --web agents/

# Opens http://localhost:8000
# - Interactive chat
# - Tool inspection
# - Session history
# - Debug panel

API Server​

# Start FastAPI server
/adk-run --api agents/

# Endpoints:
# POST /run - Execute agent
# GET /agents - List agents
# GET /sessions - List sessions

Options​

OptionDescription
--modelOverride default model
--portServer port (default: 8000)
--sessionContinue existing session
--verboseShow debug output
--traceEnable telemetry tracing

Agent Path Format​

# Relative to current directory
/adk-run agents/my_agent

# Absolute path
/adk-run /path/to/agents/my_agent

# From samples
/adk-run ~/.coditect/submodules/tools/adk-samples/python/agents/customer-service

Environment Setup​

# Set API key
export GEMINI_API_KEY="your-api-key"

# Or use Vertex AI
export GOOGLE_CLOUD_PROJECT="your-project"
export GOOGLE_CLOUD_LOCATION="us-central1"

Sample Agents​

# Try sample agents
/adk-run ~/.coditect/submodules/tools/adk-samples/python/agents/travel-concierge
/adk-run ~/.coditect/submodules/tools/adk-samples/python/agents/data-science
/adk-run ~/.coditect/submodules/tools/adk-samples/python/agents/customer-service

Prerequisites​

  • Python 3.10+ (3.11+ recommended)
  • google-adk package: pip install google-adk
  • GEMINI_API_KEY or Vertex AI credentials

Quick Install​

# Install ADK
pip install google-adk

# Or from source
pip install ~/.coditect/submodules/tools/adk-python
  • Agent: adk-agent-builder, adk-orchestrator
  • Skill: adk-tool-integration
  • Command: /adk-eval
  • Repository: google/adk-python

Version: 1.0.0 Created: 2026-01-13