openai/openai-agents-python

A lightweight, powerful framework for multi-agent workflows

Stars: 29.6k
Forks: 4.8k
Open beginner issues: 0
Indexed issues: 28
Avg merge: 1d 20h
Merged PRs (30d): 123

Dominant language: Python
License: MIT
Last GitHub push: Sep 17, 2026
Latest indexed: Sep 19, 2026
Contributing guide: Contributing guide
Code of conduct: No code of conduct
Beginner labels: No beginner labels indexed

Beginner friendly Everything

Open All

28 open issues indexed

Generated translated docs (ja/ko/zh) contain ~30 broken relative links (translate_docs.py copies English link targets verbatim) Open

Difficulty 3/5 1-2 days Newbie friendliness 78/100

openai/openai-agents-python#5092 · Opened Sep 19, 2026
Feature: memory portability across handoffs — verified memory bundles for agents and sessions Open

Difficulty 5/5 Over a week Newbie friendliness 25/100

openai/openai-agents-python#5089 · 2 comments · Opened Sep 18, 2026
Modal sandbox: evaluate native filesystem APIs and clarify overwrite compatibility Open

enhancement

Difficulty 5/5 Over a week Newbie friendliness 25/100

openai/openai-agents-python#5088 · Opened Sep 18, 2026
Local shell executor failure aborts the whole run instead of reaching the model Open

Difficulty 3/5 1-2 days Newbie friendliness 72/100

openai/openai-agents-python#5086 · Opened Sep 18, 2026
Agent.as_tool() nested subagent runs never hit prompt cache, even with byte-identical instructions/tools/prompt_cache_key Open

Difficulty 4/5 3-5 days Newbie friendliness 48/100

openai/openai-agents-python#5085 · 1 comment · Opened Sep 18, 2026
Voice: on Python 3.10 a streamed STT session-setup timeout escapes as asyncio.TimeoutError instead of STTWebsocketConnectionError Open

Difficulty 2/5 1-3 hours Newbie friendliness 45/100

openai/openai-agents-python#5074 · Opened Sep 17, 2026
Realtime: agent_end names the post-handoff agent instead of the agent whose turn ended Open

Difficulty 2/5 1-3 hours Newbie friendliness 45/100

openai/openai-agents-python#5072 · 1 comment · Opened Sep 17, 2026
Realtime: a failing model.close() leaves every waiting event iterator blocked forever Open

Difficulty 3/5 1-2 days Newbie friendliness 35/100

openai/openai-agents-python#5070 · 1 comment · Opened Sep 17, 2026
Realtime: close() keeps the previous connection's item and audio state, so a reconnect on the same model truncates and retrieves stale item ids Open

Difficulty 3/5 1-2 days Newbie friendliness 35/100

openai/openai-agents-python#5068 · Opened Sep 17, 2026
MCP: cancelling a _ServerWorker task does not stop the worker (CancelledError swallowed by except BaseException) Open

Difficulty 4/5 3-5 days Newbie friendliness 57/100

openai/openai-agents-python#5054 · 1 comment · Opened Sep 16, 2026
Skills frontmatter parser mangles multi-line descriptions (folded >, literal |, wrapped lines) in the skill index Open

Difficulty 3/5 1-2 days Newbie friendliness 70/100

openai/openai-agents-python#5026 · 1 reaction · Opened Sep 14, 2026
BackendSpanExporter drops the whole batch on HTTP 429 instead of retrying with Retry-After Open

Difficulty 3/5 1-2 days Newbie friendliness 72/100

openai/openai-agents-python#5023 · 3 comments · Opened Sep 14, 2026
RunState stringifies structured guardrail diagnostics and agent output during persistence Open

Difficulty 3/5 1-2 days Newbie friendliness 70/100

openai/openai-agents-python#5006 · 4 comments · Opened Sep 14, 2026
EncryptedSession.pop_item drains recoverable ciphertext when configured with the wrong key Open

Difficulty 4/5 3-5 days Newbie friendliness 55/100

openai/openai-agents-python#5005 · 3 comments · Opened Sep 14, 2026
ModelSettings.extra_args with a provider-native value aborts every Chat Completions model call with PydanticSerializationError Open

Difficulty 3/5 1-2 days Newbie friendliness 78/100

openai/openai-agents-python#5002 · 2 comments · Opened Sep 14, 2026
BackendSpanExporter: one metadata or custom span value that isn't JSON serializable drops the whole export batch, including unrelated traces Open

feature:tracing

Difficulty 3/5 1-2 days Newbie friendliness 68/100

openai/openai-agents-python#4983 · 4 comments · Opened Sep 13, 2026
[Sandbox] apply_patch update_file with a case-only move_to deletes the file on a case-insensitive filesystem Open

feature:sandboxes

Difficulty 3/5 1-2 days Newbie friendliness 76/100

openai/openai-agents-python#4889 · 4 comments · Opened Sep 6, 2026
Clearing a compaction session retains the previous response chain Open

feature:sessions

Difficulty 2/5 1-3 hours Newbie friendliness 76/100

openai/openai-agents-python#4864 · 2 comments · Opened Sep 4, 2026
Sandbox tar extraction and 12 sandbox tests fail on Windows without symlink privilege Open

feature:sandboxes project

Difficulty 4/5 3-5 days Newbie friendliness 52/100

openai/openai-agents-python#4852 · 1 comment · Opened Sep 4, 2026
Count replayed program items as parents with client-managed input Open

feature:core

Difficulty 3/5 1-2 days Newbie friendliness 78/100

openai/openai-agents-python#4839 · 1 comment · Opened Sep 3, 2026
Deferred interrupted-turn session items are never persisted when an approval resume goes through next_step_run_again, leaving an orphaned function_call_output Open

feature:sessions

Difficulty 4/5 3-5 days Newbie friendliness 35/100

openai/openai-agents-python#4827 · 11 comments · Opened Sep 2, 2026
RunState pending input can be duplicated when a Session append loses acknowledgement Open

feature:sessions

Difficulty 4/5 3-5 days Newbie friendliness 48/100

openai/openai-agents-python#4775 · 5 comments · Opened Aug 30, 2026
SQLAlchemySession(create_tables=True) cannot create tables on MySQL due to unbounded String columns Open

feature:sessions

Difficulty 3/5 1-2 days Newbie friendliness 68/100

openai/openai-agents-python#4740 · 2 comments · Opened Aug 28, 2026
Add native OIDC authentication support to Modal cloud bucket mounts Open

enhancement feature:sandboxes

Difficulty 3/5 1-2 days Newbie friendliness 74/100

openai/openai-agents-python#4705 · 2 comments · Opened Aug 27, 2026
Planned changes for v1.0 release Open

enhancement feature:core

openai/openai-agents-python#2921 · 1 assignee · Opened Apr 17, 2026
Traces appear but spans show "No spans found" despite successful export Open

feature:tracing server issue

Difficulty 4/5 3-5 days Newbie friendliness 52/100

openai/openai-agents-python#2477 · 9 comments · Opened Feb 13, 2026
Change trace_include_sensitive_data defaults to True in future releases Open

feature:core feature:tracing

Difficulty 2/5 1-3 hours Newbie friendliness 25/100

openai/openai-agents-python#2393 · 2 comments · Opened Feb 1, 2026
Reasoning summaries should be send in the language of the user Open

enhancement server issue

Difficulty 4/5 3-5 days Newbie friendliness 38/100

openai/openai-agents-python#2049 · 6 comments · Opened Nov 6, 2025

A short digest of beginner-friendly GitHub issues.