Install

Language: 简体中文 | 日本語 | 四川话 | English

Requires Python 3.11+.

pip

pip install pagent
pip install "pagent[search]"   # optional web_search tool

uv

uv is a fast Python package and project manager (official docs).

uv pip install pagent
uv pip install "pagent[search]"

# or in a uv-managed project
uv add pagent
uv add "pagent[search]"

uvx (terminal REPL, no install)

Run the interactive CLI without adding the package to a project:

export DEEPSEEK_API_KEY="your-key"
uvx pagent
uvx pagent --thread-id demo

From a git checkout or local wheel:

uvx --from . pagent
uvx --from git+https://github.com/SyncLionPaw/pagent pagent

In a cloned pagent repo (contributors):

uv sync --group dev --extra search
uv run python -c "import pagent; print(pagent.__version__)"

conda

conda activate your-env
pip install pagent
pip install "pagent[search]"

Conda envs usually install PyPI packages with pip inside the activated environment. Check conda-forge if you prefer a conda package when available.

Optional extras

Extra	Install	Purpose
search	pip install "pagent[search]"	Built-in web_search tool (ddgs)
tokens	pip install "pagent[tokens]"	HuggingFace tokenizers for some models

See Providers & API keys for API keys and backends.

Next

Quick start — minimal agent and streaming APIs.