Install VeADK to create and run agents in Python. This page covers the released 1.1.26 version; production projects should pin this version or another internally verified version.
Prerequisites
- Python 3.10 through 3.13, with pip available in that environment
- An available model and API key to run an agent; installing the package does not require model credentials. See the Quickstart for Volcengine and BytePlus configuration
Install 1.1.26
Create a virtual environment in your project directory to isolate its dependencies:
Activate the environment:
macOS / Linux
Windows PowerShell
Install 1.1.26 from PyPI and check the installation:
The second command should print 1.1.26. The Python requirements and extras on this page were checked against release 1.1.26.
Optional dependency groups
Install extras for the integrations you need. For example, install extensions for Feishu, Cozeloop, or LlamaIndex:
If you pin the base package, use the same version for extras, for example veadk-python[extensions]==1.1.26.
Install 1.1.26 from source
Install Git and uv, then clone the public repository at the 1.1.26 tag. Create an isolated environment inside the repository and install VeADK in editable mode:
To include an extra, replace the installation command with uv pip install -e ".[extensions]"
Activate the repository’s .venv using the instructions above, then run the version check command. With an editable installation, changes to the repository’s Python source apply to that environment
To run your first agent, see the Quickstart. Last modified on November 11, 2026