Principle:Openai Openai agents python Package Configuration
| Knowledge Sources | |
|---|---|
| Domains | Package_Management, Build_Configuration |
| Last Updated | 2026-02-11 00:00 GMT |
Overview
Declarative specification of the SDK package metadata, dependencies, build system, and development tooling configuration.
Description
Package Configuration defines the complete build and distribution specification for the openai-agents Python package using `pyproject.toml` (PEP 621). It declares the package identity (name, version, license, authors), Python version requirements (>=3.9), core dependencies (openai, pydantic, griffe, typing-extensions, requests, mcp), and optional dependency groups for extended functionality (voice, visualization, LiteLLM, realtime, SQLAlchemy, encryption, Redis, Dapr).
The configuration also specifies the build system (hatchling), source layout (`src/agents`), and development tool settings for linting (ruff), type checking (mypy), testing (pytest with asyncio), code coverage, and formatting. This single file serves as the authoritative source for all package metadata and tooling configuration.
Usage
Consult this configuration when installing the SDK, understanding available optional features, checking version compatibility, or configuring development tooling. The optional dependency groups determine which extra features are available (e.g., `pip install openai-agents[voice]` for voice support).
Theoretical Basis
Package Configuration follows the declarative build specification pattern standardized in PEP 621:
Pseudo-code Logic:
# Abstract package resolution
package = read_pyproject_toml("pyproject.toml")
core_deps = resolve(package.dependencies) # always installed
optional_deps = resolve(package.optional[extras]) # on request
build_backend = package.build_system.backend # hatchling
wheel = build_backend.build(source_dir="src/agents")