Skip to content

Installation

Requirements

  • Python 3.10 or newer
  • pydantic-ai-slim 2.38 or newer (installed automatically)

Install

pip install pydantic-ai-skills

This pulls in everything needed to discover skills from the filesystem, load their instructions and resources, and run their scripts:

  • pydantic-ai-harness[skills] — reads and validates SKILL.md packages, and turns each one into a deferred Pydantic AI capability. This package builds on it rather than reimplementing it; see pydantic-ai-skills and pydantic-ai-harness.
  • pydantic-ai-slim — the Pydantic AI agent framework
  • pyyaml — reads frontmatter when staging composed registries
  • anyio — async process handling for script execution

No extras are required for the core workflow described in the Quick Start.

Optional extras

Some features depend on additional packages. Install the matching extra:

Extra Install Enables
opensandbox pip install "pydantic-ai-skills[opensandbox]" OpenSandboxScriptExecutor — run skill scripts in a container
localsandbox pip install "pydantic-ai-skills[localsandbox]" LocalSandboxScriptExecutor — run skill scripts in a virtual filesystem (Python 3.12+)
git pip install "pydantic-ai-skills[git]" GitSkillsRegistry — load skills from Git repositories
s3 pip install "pydantic-ai-skills[s3]" S3SkillsRegistry — load skills from S3 buckets
test pip install "pydantic-ai-skills[test]" pytest and coverage tooling
dev pip install "pydantic-ai-skills[dev]" ruff, mypy, and pre-commit
docs pip install "pydantic-ai-skills[docs]" MkDocs and the docs toolchain
examples pip install "pydantic-ai-skills[examples]" dependencies used by the bundled examples

Extras can be combined:

pip install "pydantic-ai-skills[git,s3]"

See Skill Registries for what the git and s3 extras unlock.

Install from source

git clone https://github.com/dougtrajano/pydantic-ai-skills.git
cd pydantic-ai-skills
pip install -e .

Setting up a development environment instead? See Contributing.

Verify the installation

python -c "from importlib.metadata import version; print(version('pydantic-ai-skills'))"

Model provider credentials

pydantic-ai-skills does not talk to model providers itself — Pydantic AI does. Install and configure whichever provider your agent uses, for example:

pip install "pydantic-ai-slim[openai]"
export OPENAI_API_KEY=...

See the Pydantic AI models documentation for the full list.

Next steps