Installation - AgentKit 文档

Prerequisites

Python 3.10 or later.
A Volcengine Ark API key for calling models, created in the Ark console.

Install the released baseline

Install VeADK 1.0.9 from PyPI:

pip install "veadk-python==1.0.9"

Optional dependency groups

VeADK provides optional dependency groups (extras) for on-demand capabilities, installed individually as needed:

pip install "veadk-python[extensions]"

Extra	Purpose
`extensions`	Feishu channel, Cozeloop, LlamaIndex, and related integrations
`database`	Redis, MySQL, Viking DB, mem0, and other storage backends
`eval`	Evaluation via DeepEval and Google ADK
`a2ui`	A2UI (agent-driven UI)
`harness`	Harness servers and the Headroom integration
`pdf`	Backward-compatible install alias; PDF rendering dependencies are installed by default starting in 1.0.5

The speech and cli extras remain available for compatibility with existing install commands but add no dependencies starting in 1.0.5.

Install the Preview source

The Preview source is the current main line of the public VeADK repository. Create an isolated environment and install it with uv:

git clone --depth 1 https://github.com/volcengine/veadk-python.git
cd veadk-python

# Create a Python 3.12 virtual environment
uv venv --python 3.12

# Install dependencies (add --extra <name> or --all-extras for extras)
uv sync --all-extras

# Install VeADK in editable mode
uv pip install -e .

The main line can continue to change and does not carry the compatibility guarantees of a released version. Use a pinned PyPI release in production; use the Preview source only to evaluate unreleased capabilities or contribute changes. Once installed, continue to the Quickstart to run your first agent.

Last modified on September 19, 2026