pyproject.toml

[project]
name = "openai-agents"
version = "0.24.0"
description = "OpenAI Agents SDK"
readme = "README.md"
requires-python = ">=3.10"
license = "MIT"
authors = [{ name = "OpenAI", email = "support@openai.com" }]
dependencies = [
    "openai>=3.0.0,<4",
    "pydantic>=2.12.2, <3",
    "griffelib>=2, <3",
    "typing-extensions>=4.12.2, <5",
    "requests>=2.0, <3",
    "websockets>=15.0, <17",
    # GHSA-rwrf-2pqf-9j8j: retain patched MCP 1.x and 2.x releases.
    "mcp>=1.30.0, <3, !=2.0.*, !=2.1.*; python_version >= '3.10'",
    # Security floors for transitive runtime dependencies.
    "certifi>=2026.10.19",
    "httpx2>=2.12.0",
    "pyjwt>=2.15.0",
    "python-multipart>=0.0.31",
    "starlette>=1.3.1",
    "urllib3>=2.8.0",
]
classifiers = [
    "Typing :: Typed",
    "Intended Audience :: Developers",
    "Programming Language :: Python :: 3",
    "Programming Language :: Python :: 3.10",
    "Programming Language :: Python :: 3.11",
    "Programming Language :: Python :: 3.12",
    "Programming Language :: Python :: 3.13",
    "Programming Language :: Python :: 3.14",
    "Operating System :: OS Independent",
    "Topic :: Software Development :: Libraries :: Python Modules",
    "License :: OSI Approved :: MIT License",
]

[project.urls]
Homepage = "https://openai.github.io/openai-agents-python/"
Repository = "https://github.com/openai/openai-agents-python"

[project.optional-dependencies]
# Protobuf exclusions retain patched 5.x and 6.x releases (GHSA-7gcm-g887-7qv7).
voice = ["numpy>=2.2.0, <3; python_version>='3.10'", "websockets>=15.0, <17"]
viz = ["graphviz>=0.17"]
litellm = ["litellm>=1.83.0", "aiohttp>=3.14.3,<4", "filelock>=3.20.3"]
any-llm = [
    "any-llm-sdk>=1.11.0, <2; python_version >= '3.11'",
    "pygments>=2.20.0; python_version >= '3.11'",
]
realtime = ["websockets>=15.0, <17"]
sqlalchemy = ["SQLAlchemy[asyncio]>=2.0", "asyncpg>=0.29.0"]
encrypt = ["cryptography>=45.0,<51"]
redis = ["redis>=7"]
dapr = [
    "dapr>=1.16.0",
    "grpcio>=1.60.0",
    "aiohttp>=3.14.3,<4",
    "protobuf>=5.29.6,!=6.30.*,!=6.31.*,!=6.32.*,!=6.33.0.*,!=6.33.1.*,!=6.33.2.*,!=6.33.3.*,!=6.33.4.*",
]
mongodb = ["pymongo>=4.18.3"]
docker = ["docker>=6.1"]
blaxel = ["blaxel>=0.2.50", "aiohttp>=3.14.3,<4"]
daytona = [
    "daytona>=0.226.1",
    "aiohttp>=3.14.3,<4",
    "protobuf>=5.29.6,!=6.30.*,!=6.31.*,!=6.32.*,!=6.33.0.*,!=6.33.1.*,!=6.33.2.*,!=6.33.3.*,!=6.33.4.*",
]
cloudflare = ["aiohttp>=3.14.3,<4"]
e2b = [
    "e2b==2.31.0",
    "e2b-code-interpreter==2.8.1",
    "h2>=4.4.1",
    "protobuf>=5.29.6,!=6.30.*,!=6.31.*,!=6.32.*,!=6.33.0.*,!=6.33.1.*,!=6.33.2.*,!=6.33.3.*,!=6.33.4.*",
    "pygments>=2.20.0",
]
modal = [
    "modal==1.4.3",
    "aiohttp>=3.14.3,<4",
    "cbor2>=5.9.0",
    "h2>=4.4.1",
    "protobuf>=5.29.6,!=6.30.*,!=6.31.*,!=6.32.*,!=6.33.0.*,!=6.33.1.*,!=6.33.2.*,!=6.33.3.*,!=6.33.4.*",
    "pygments>=2.20.0",
]
vercel = ["vercel-sandbox>=0.7.0,<0.9", "cbor2>=5.9.0"]
s3 = ["boto3>=1.34"]
temporal = [
    "temporalio==1.34.0",
    "textual>=8.2.3,<8.3",
    "protobuf>=5.29.6,!=6.30.*,!=6.31.*,!=6.32.*,!=6.33.0.*,!=6.33.1.*,!=6.33.2.*,!=6.33.3.*,!=6.33.4.*",
    "pygments>=2.20.0",
]

[dependency-groups]
dev = [
  "mypy",
  "ruff==0.17.1",
  "pytest>=9.0.3",
  "pytest-asyncio",
  "pytest-mock>=3.14.0",
  "pytest-xdist",
  "rich>=13.1.0, <15",
  "mkdocs>=1.6.0",
  "mkdocs-material>=9.7.7",
  "pymdown-extensions>=11.0.1",
  "pygments>=2.20.0",
  "mkdocstrings[python]>=0.28.0",
  "mkdocs-static-i18n",
  "coverage>=7.6.12",
  "playwright==1.63.0",
  "inline-snapshot>=0.20.7",
  "pynput",
  "types-pynput",
  "sounddevice",
  "textual",
  "websockets",
  "graphviz",
  "mkdocs-static-i18n>=1.3.0",
  "eval-type-backport>=0.2.2",
  "fastapi >= 0.110.0, <1",
  "aiosqlite>=0.21.0",
  "cryptography>=45.0,<51",
  "fakeredis>=2.31.3",
  "dapr>=1.14.0",
  "aiohttp>=3.14.3,<4",
  "protobuf>=5.29.6,!=6.30.*,!=6.31.*,!=6.32.*,!=6.33.0.*,!=6.33.1.*,!=6.33.2.*,!=6.33.3.*,!=6.33.4.*",
  "grpcio>=1.60.0",
  "pyright==1.1.408",
  "pymongo>=4.18.3",
  "twilio>=9,<10",
]

[tool.uv.workspace]
members = ["agents"]

[tool.uv.sources]
agents = { workspace = true }

[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"

[tool.hatch.build]
exclude = [
    "/.agents",
    "/.github",
    "/.tmp*",
    "/.uv*",
    "/integration_tests",
]

[tool.hatch.build.targets.wheel]
packages = ["src/agents"]


[tool.ruff]
line-length = 100
target-version = "py310"

[tool.ruff.format]
# Translated documentation is generated; format only the English source.
exclude = ["docs/ja/**", "docs/ko/**", "docs/zh/**"]

[tool.ruff.lint]
select = [
  "E",  # pycodestyle errors
  "W",  # pycodestyle warnings
  "F",  # pyflakes
  "I",  # isort
  "B",  # flake8-bugbear
  "C4", # flake8-comprehensions
  "ASYNC", # flake8-async
  "DTZ005", # datetime.now() without a timezone
  "G004", # logging statement uses f-string
  "RUF006", # unowned asyncio tasks
  "RUF012", # mutable class attributes without ClassVar
  "RUF100", # unused noqa directives
  "TRY201", # needless exception name in raise statements
  "UP", # pyupgrade
]
isort = { combine-as-imports = true, known-first-party = ["agents"] }
logger-objects = ["agents.logger.logger"]

[tool.ruff.lint.pydocstyle]
convention = "google"

[tool.ruff.lint.per-file-ignores]
"examples/**/*.py" = ["ASYNC", "DTZ005", "E501", "G004", "RUF006", "RUF012", "RUF100"]
"examples/**/*.ipynb" = ["RUF100"]
"tests/**/*.py" = ["ASYNC", "RUF006", "RUF012", "RUF100"]

[tool.mypy]
strict = true
disallow_incomplete_defs = false
disallow_untyped_defs = false
disallow_untyped_calls = false

[[tool.mypy.overrides]]
module = "sounddevice.*"
ignore_missing_imports = true

[[tool.mypy.overrides]]
module = ["modal", "modal.*"]
ignore_missing_imports = true

[[tool.mypy.overrides]]
module = ["e2b", "e2b.*"]
ignore_missing_imports = true

[[tool.mypy.overrides]]
module = ["daytona", "daytona.*"]
ignore_missing_imports = true

[[tool.mypy.overrides]]
module = ["blaxel", "blaxel.*"]
ignore_missing_imports = true

[[tool.mypy.overrides]]
module = ["vercel", "vercel.*"]
ignore_missing_imports = true

[tool.coverage.run]
source = ["src/agents"]
omit = [
  "tests/*",
  "src/agents/sandbox/sandboxes/*.py",
  "src/agents/sandbox/task_context.py",
  "src/agents/sandbox/task_runtime.py",
  "src/agents/sandbox/materialization.py",
  "src/agents/sandbox/entries/artifacts.py",
  "src/agents/sandbox/entries/mounts/*.py",
  "src/agents/sandbox/util/checksums.py",
  "src/agents/sandbox/util/deep_merge.py",
  "src/agents/sandbox/util/github.py",
  "src/agents/sandbox/util/iterator_io.py",
  "src/agents/sandbox/util/parse_utils.py",
  "src/agents/sandbox/util/tar_utils.py",
]

[tool.coverage.report]
show_missing = true
sort = "-Cover"
exclude_also = [
  # This is only executed while typechecking
  "if TYPE_CHECKING:",
  "@abc.abstractmethod",
  "raise NotImplementedError",
  "logger.debug",
]

[tool.pytest.ini_options]
asyncio_mode = "auto"
asyncio_default_fixture_loop_scope = "session"
testpaths = ["tests"]
filterwarnings = [
  # This is a warning that is expected to happen: we have an async filter that raises an exception
  "ignore:coroutine 'test_async_input_filter_fails.<locals>.invalid_input_filter' was never awaited:RuntimeWarning",
]
markers = [
  "allow_call_model_methods: mark test as allowing calls to real model implementations",
  "requires_native_macos_sandbox: mark test as requiring its own macOS sandbox-exec process",
  "review_optional: mark a slow subsystem-specific test that an unrelated iterative review check may omit",
  "serial: mark test as requiring exclusive execution after all xdist workers exit",
]

[tool.inline-snapshot]
format-command = "ruff format --stdin-filename {filename}"

[tool.uv]
exclude-newer = "7 days"
exclude-newer-package = { openai = false }
index-strategy = "first-index"

[tool.uv.pip]
exclude-newer = "7 days"
exclude-newer-package = { openai = false }
index-strategy = "first-index"