{"id":26201706,"url":"https://github.com/openai/openai-agents-python","last_synced_at":"2026-05-11T09:09:23.552Z","repository":{"id":281887741,"uuid":"946380199","full_name":"openai/openai-agents-python","owner":"openai","description":"A lightweight, powerful framework for multi-agent workflows","archived":false,"fork":false,"pushed_at":"2026-04-30T03:19:21.000Z","size":28726,"stargazers_count":25576,"open_issues_count":64,"forks_count":3902,"subscribers_count":201,"default_branch":"main","last_synced_at":"2026-04-30T05:03:15.210Z","etag":null,"topics":["agents","ai","framework","llm","openai","python"],"latest_commit_sha":null,"homepage":"https://openai.github.io/openai-agents-python/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/openai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-03-11T03:42:36.000Z","updated_at":"2026-04-30T04:55:17.000Z","dependencies_parsed_at":"2026-04-09T06:02:15.893Z","dependency_job_id":null,"html_url":"https://github.com/openai/openai-agents-python","commit_stats":null,"previous_names":["openai/openai-agents-python"],"tags_count":88,"template":false,"template_full_name":null,"purl":"pkg:github/openai/openai-agents-python","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openai%2Fopenai-agents-python","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openai%2Fopenai-agents-python/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openai%2Fopenai-agents-python/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openai%2Fopenai-agents-python/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/openai","download_url":"https://codeload.github.com/openai/openai-agents-python/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openai%2Fopenai-agents-python/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32503357,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-30T13:12:12.517Z","status":"online","status_checked_at":"2026-05-01T02:00:05.856Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agents","ai","framework","llm","openai","python"],"created_at":"2025-03-12T03:23:23.569Z","updated_at":"2026-05-07T02:03:08.136Z","avatar_url":"https://github.com/openai.png","language":"Python","funding_links":[],"categories":["Coding Tools for Economists","AI Agent Frameworks","Agent Development Frameworks","🔗 エージェントプロトコルと標準","Python","🤖 AI \u0026 Machine Learning","2024-2026 重要项目","NLP","🕵️ 智能体（Agents）","Design Primitives","Agents","HarmonyOS","AI and Agents","Tools","A01_文本生成_文本对话","LLM Providers","🧱 Agent Frameworks","Agent Frameworks","Repos","🧠 AI Applications \u0026 Platforms","Projects","Frameworks \u0026 Libraries","Orchestration Frameworks","📦 Official Examples","Agentic Frameworks","AI Agent Frameworks \u0026 SDKs","Agent SDKs \u0026 Frameworks","1. Agent Frameworks (Production-Ready)","\u003ca name=\"Python\"\u003e\u003c/a\u003ePython","2. Libraries \u0026 Frameworks","🤖 Agent Frameworks \u0026 Multi-Agent Systems","Tools and Code","Frameworks","Agent Frameworks \u0026 Examples","Tooling \u0026 Services","🧩 Agent Frameworks \u0026 Dev Libraries","4. Agentic AI \u0026 Multi-Agent Systems","🤖 AI Agent Frameworks","🚀 Specialized Agents","未分类","Agent Framework","Best starting points","Catalog","Orchestration","⚡ Quick Picks","3）参考实现与开源工具（GitHub）"],"sub_categories":["AI Agent Frameworks","General Agent Frameworks","その他の標準","主流 Agent 框架","Task Runners \u0026 Orchestration","Agent SDKs","Windows Manager","Agent Frameworks","大语言对话模型及数据","Multi-Agent Orchestration","Community","Tools","AI and Agents","Multi-Agent Collaboration Systems","Official Vendor SDKs","Python","Advanced Agent Orchestration","Frameworks","Specialized Tools","🗣️ Programming Language Agents","Harness Architecture \u0026 Orchestration","Agent Framework","AI Native 工具"],"readme":"# OpenAI Agents SDK [![PyPI](https://img.shields.io/pypi/v/openai-agents?label=pypi%20package)](https://pypi.org/project/openai-agents/)\n\nThe OpenAI Agents SDK is a lightweight yet powerful framework for building multi-agent workflows. It is provider-agnostic, supporting the OpenAI Responses and Chat Completions APIs, as well as 100+ other LLMs.\n\n\u003cimg src=\"https://cdn.openai.com/API/docs/images/orchestration.png\" alt=\"Image of the Agents Tracing UI\" style=\"max-height: 803px;\"\u003e\n\n\u003e [!NOTE]\n\u003e Looking for the JavaScript/TypeScript version? Check out [Agents SDK JS/TS](https://github.com/openai/openai-agents-js).\n\n### Core concepts:\n\n1. [**Agents**](https://openai.github.io/openai-agents-python/agents): LLMs configured with instructions, tools, guardrails, and handoffs\n1. [**Sandbox Agents**](https://openai.github.io/openai-agents-python/sandbox_agents): Agents preconfigured to work with a container to perform work over long time horizons.\n1. **[Agents as tools](https://openai.github.io/openai-agents-python/tools/#agents-as-tools) / [Handoffs](https://openai.github.io/openai-agents-python/handoffs/)**: Delegating to other agents for specific tasks\n1. [**Tools**](https://openai.github.io/openai-agents-python/tools/): Various Tools let agents take actions (functions, MCP, hosted tools)\n1. [**Guardrails**](https://openai.github.io/openai-agents-python/guardrails/): Configurable safety checks for input and output validation\n1. [**Human in the loop**](https://openai.github.io/openai-agents-python/human_in_the_loop/): Built-in mechanisms for involving humans across agent runs\n1. [**Sessions**](https://openai.github.io/openai-agents-python/sessions/): Automatic conversation history management across agent runs\n1. [**Tracing**](https://openai.github.io/openai-agents-python/tracing/): Built-in tracking of agent runs, allowing you to view, debug and optimize your workflows\n1. [**Realtime Agents**](https://openai.github.io/openai-agents-python/realtime/quickstart/): Build powerful voice agents with `gpt-realtime-1.5` and full agent features\n\nExplore the [examples](https://github.com/openai/openai-agents-python/tree/main/examples) directory to see the SDK in action, and read our [documentation](https://openai.github.io/openai-agents-python/) for more details.\n\n## Get started\n\nTo get started, set up your Python environment (Python 3.10 or newer required), and then install OpenAI Agents SDK package.\n\n### venv\n\n```bash\npython -m venv .venv\nsource .venv/bin/activate  # On Windows: .venv\\Scripts\\activate\npip install openai-agents\n```\n\nFor voice support, install with the optional `voice` group: `pip install 'openai-agents[voice]'`. For Redis session support, install with the optional `redis` group: `pip install 'openai-agents[redis]'`.\n\n### uv\n\nIf you're familiar with [uv](https://docs.astral.sh/uv/), installing the package would be even easier:\n\n```bash\nuv init\nuv add openai-agents\n```\n\nFor voice support, install with the optional `voice` group: `uv add 'openai-agents[voice]'`. For Redis session support, install with the optional `redis` group: `uv add 'openai-agents[redis]'`.\n\n## Run your first Sandbox Agent\n\n[Sandbox Agents](https://openai.github.io/openai-agents-python/sandbox_agents) are new in version 0.14.0. A sandbox agent is an agent that uses a computer environment to perform real work with a filesystem, in an environment you configure and control. Sandbox agents are useful when the agent needs to inspect files, run commands, apply patches, or carry workspace state across longer tasks.\n\n```python\nfrom agents import Runner\nfrom agents.run import RunConfig\nfrom agents.sandbox import Manifest, SandboxAgent, SandboxRunConfig\nfrom agents.sandbox.entries import GitRepo\nfrom agents.sandbox.sandboxes import UnixLocalSandboxClient\n\nagent = SandboxAgent(\n    name=\"Workspace Assistant\",\n    instructions=\"Inspect the sandbox workspace before answering.\",\n    default_manifest=Manifest(\n        entries={\n            \"repo\": GitRepo(repo=\"openai/openai-agents-python\", ref=\"main\"),\n        }\n    ),\n)\n\nresult = Runner.run_sync(\n    agent,\n    \"Inspect the repo README and summarize what this project does.\",\n    # Run this agent on the local filesystem\n    run_config=RunConfig(sandbox=SandboxRunConfig(client=UnixLocalSandboxClient())),\n)\nprint(result.final_output)\n\n# This project provides a Python SDK for building multi-agent workflows.\n```\n\n(_If running this, ensure you set the `OPENAI_API_KEY` environment variable_)\n\n(_For Jupyter notebook users, see [hello_world_jupyter.ipynb](https://github.com/openai/openai-agents-python/blob/main/examples/basic/hello_world_jupyter.ipynb)_)\n\nExplore the [examples](https://github.com/openai/openai-agents-python/tree/main/examples) directory to see the SDK in action, and read our [documentation](https://openai.github.io/openai-agents-python/) for more details.\n\n## Acknowledgements\n\nWe'd like to acknowledge the excellent work of the open-source community, especially:\n\n- [Pydantic](https://docs.pydantic.dev/latest/)\n- [Requests](https://github.com/psf/requests)\n- [MCP Python SDK](https://github.com/modelcontextprotocol/python-sdk)\n- [Griffe](https://github.com/mkdocstrings/griffe)\n\nThis library has these optional dependencies:\n\n- [websockets](https://github.com/python-websockets/websockets)\n- [SQLAlchemy](https://github.com/sqlalchemy/sqlalchemy)\n- [any-llm](https://github.com/mozilla-ai/any-llm) and [LiteLLM](https://github.com/BerriAI/litellm)\n\nWe also rely on the following tools to manage the project:\n\n- [uv](https://github.com/astral-sh/uv) and [ruff](https://github.com/astral-sh/ruff)\n- [mypy](https://github.com/python/mypy) and [Pyright](https://github.com/microsoft/pyright)\n- [pytest](https://github.com/pytest-dev/pytest) and [Coverage.py](https://github.com/coveragepy/coveragepy)\n- [MkDocs](https://github.com/squidfunk/mkdocs-material)\n\nWe're committed to continuing to build the Agents SDK as an open source framework so others in the community can expand on our approach.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenai%2Fopenai-agents-python","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopenai%2Fopenai-agents-python","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenai%2Fopenai-agents-python/lists"}