google/adk-python

View on GitHub

An open-source, code-first Python toolkit for building, evaluating, and deploying sophisticated AI agents with flexibility and control.

Stars: 21.5k
Forks: 4k
Open beginner issues: 1
Indexed issues: 271
Avg merge: 1d 14h
Merged PRs (30d): 37

Dominant language: Python
License: Apache-2.0
Last GitHub push: Sep 15, 2026
Latest indexed: Sep 16, 2026
Contributing guide: Contributing guide
Code of conduct: Code of conduct
Beginner labels: help wanted

Open All

259 open issues indexed

MCPSessionManager pools a server-terminated streamable-HTTP session forever: `_is_session_disconnected` only checks local stream flags (scope of closed #3321, still broken in v2.7.1) Open

mcp request clarification

google/adk-python#6822 · 5 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
Support the MCP Tasks extension (SEP-2663) in McpToolset: expose the mcp 2.x client extension seam Open

mcp

google/adk-python#6826 · 3 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
Live multi-agent runs turn audio transcription back on after the caller disabled it Open

live

google/adk-python#6827 · 0 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
Backport `perf: cache the FunctionTool declaration` (57f3af24) to the 1.x line Open

needs review tools

google/adk-python#6833 · 1 comment · 0 reactions · 1 assignee · Indexed Sep 16, 2026
`GoogleSearchAgentTool` parallel responses fail to serialize deferred `GroundingMetadata` (`MockValSer`) Open

tools

google/adk-python#6848 · 4 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
Session state does not cross a RemoteA2aAgent boundary in either direction, silently Open

a2a needs review

google/adk-python#6854 · 8 comments · 0 reactions · 2 assignees · Indexed Sep 16, 2026
to_openeval()/from_openeval(): interop between EvalSet and the EvalPort portable format Open

eval needs review

google/adk-python#6871 · 6 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
Hide certain artifacts from the LLM in LoadArtifactsTool Open

needs review tools

google/adk-python#6873 · 1 comment · 0 reactions · 1 assignee · Indexed Sep 16, 2026
Annotated type hint metadata not preserved in function tool declarations/tool schema Open

request clarification spam tools

google/adk-python#6877 · 7 comments · 3 reactions · 1 assignee · Indexed Sep 16, 2026
Annotated parameters breaks `_preprocess_args` when using recursive type aliases or any unresolvable forward reference Open

core request clarification

google/adk-python#6878 · 3 comments · 3 reactions · 1 assignee · Indexed Sep 16, 2026
A custom BaseLlm has no documented mapping from LlmRequest.config to a Vertex request body, and getting it wrong drops your tools with no error Open

models

google/adk-python#6880 · 5 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
`create_gcs_eval_managers_from_uri` doesn't extract bucket from path, contradicting its own docstring Open

eval

google/adk-python#6881 · 3 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
GcpSkillRegistry.get_skill() always fails with 302: Agent Registry media download redirect to GCS signed URL is not followed Open

services

google/adk-python#6908 · 1 comment · 1 reaction · 1 assignee · Indexed Sep 16, 2026
api_server: unbounded in-memory trace retention (ApiServerSpanExporter.trace_dict / InMemoryExporter._spans) with web=False — ~200 KB leaked per LLM turn, OOM under min-instances >= 1 Open

request clarification tracing

google/adk-python#6915 · 2 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
AgentCoreSessionService extending BaseSessionService for AgentCore Memory Open

agent engine needs review

google/adk-python#6920 · 4 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
Dockerfile should first copy requirements.txt and install dependencies before copying agent code Open

needs review services

google/adk-python#6923 · 4 comments · 0 reactions · 2 assignees · Indexed Sep 16, 2026
Session id is normalized on write but not on read: after bfeb04c a padded id creates a session that cannot be read, deleted, or re-created (in_memory and sqlite, incl. the adk web / adk run store) Open

core needs review

google/adk-python#6941 · 3 comments · 0 reactions · 2 assignees · Indexed Sep 16, 2026
No way to delete memories from a MemoryService Open

needs review services

google/adk-python#6949 · 3 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
[BUG]: LiteLlm.capabilities hardcodes output_schema_and_tools=True, bypassing the SetModelResponseTool workaround Open

models

google/adk-python#6954 · 4 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
sample: Model Armor tool-output screening via after_tool_callback Open

needs review tools

google/adk-python#6964 · 1 comment · 0 reactions · 1 assignee · Indexed Sep 16, 2026
feat(model_armor): screen tool output in ModelArmorPlugin (or companion plugin) Open

models needs review spam

google/adk-python#6966 · 4 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
IntEnum tool parameters produce an invalid function declaration: integer values in a STRING enum Open

tools

google/adk-python#6978 · 5 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
[Feature Request]: Expose current callback hook metadata in Context Open

core needs review

google/adk-python#6979 · 1 comment · 1 reaction · 1 assignee · Indexed Sep 16, 2026
AutoTracingPlugin rebinds what getmembers() returns, not what the class holds: @staticmethod becomes an instance method, @classmethod is never traced, base methods get pinned onto subclasses Open

needs review tracing

google/adk-python#6980 · 4 comments · 0 reactions · 2 assignees · Indexed Sep 16, 2026
AnthropicLlm raises NotImplementedError on empty text parts that ADK itself emits (e.g. code execution with no output) Open

models

google/adk-python#6982 · 1 comment · 0 reactions · 1 assignee · Indexed Sep 16, 2026
[legacy path] Nested pydantic model tool parameter fails under VERTEX_AI when the function also has a fallback-parsed parameter — only with JSON_SCHEMA_FOR_FUNC_DECL disabled Open

request clarification tools

google/adk-python#6984 · 9 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
convert_a2a_message_to_event and convert_a2a_artifact_update_to_event discard the long_running_tool_ids they recover, while the two sibling converters in the same file pass them through Open

a2a

google/adk-python#6988 · 2 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
RestApiTool silently sends an empty request body when the OpenAPI schema uses oneOf/anyOf/allOf Open

tools

google/adk-python#6991 · 4 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
LiteLlm streaming keeps only the last tool call when one chunk carries N calls plus a finish_reason (latent) Open

models

google/adk-python#7004 · 3 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
chore: eval extra's google-cloud-aiplatform bound has no upper cap, unlike all/gcp/test Open

eval

google/adk-python#7009 · 2 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
`require_confirmation` callable returning a non-bool skips the confirmation gate: `cast(bool, ...)` is not a runtime check Open

core request clarification

google/adk-python#7010 · 5 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
Proposal: Add SnowflakeCortexAgent as a BaseAgent adapter Open

models needs review

google/adk-python#7014 · 3 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
Cloud telemetry export fails with invalid_scope when ADC is a service-account key file Open

request clarification tracing

google/adk-python#7024 · 2 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
scripts/check_new_py_files.py misses added files on Windows under jj and hg Open

request clarification tools

google/adk-python#7029 · 3 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
Artifact services (in_memory, file, GCS) key storage on raw session_id — padded id creates a session it cannot reach Open

services

google/adk-python#7030 · 2 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
adk web GET/DELETE test endpoints skip the create_test path sanitiser Open

request clarification web

google/adk-python#7033 · 5 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
Parallel calls to the same streaming tool leave an orphan task after live teardown Open

live request clarification

google/adk-python#7058 · 2 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
MCP session stale after server scale-to-zero - @retry_on_errors reuses dead cached session Open

mcp request clarification spam

google/adk-python#7060 · 6 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
RestApiTool path parameters with '.' / '..' still reach the wire after quote(safe="") Open

tools

google/adk-python#7065 · 4 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
`adk web --url_prefix` doesn't fix /docs and /openapi.json behind a reverse proxy Open

request clarification web

google/adk-python#7070 · 3 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
Resumable mode dispatches caller-authored function calls with no model turn or author check Open

agent engine

google/adk-python#7076 · 2 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
A before_agent_callback which changes the state results in an empty Event being returned Open

agent engine request clarification

google/adk-python#7078 · 11 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
[Feature] Add --state_file to adk run for loading initial session state from JSON Open

core needs review

google/adk-python#7083 · 2 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
Feature request: let a background AgentTool/dispatched agent's own intermediate events be observed live (not just wait=false + poll for the final result) Open

needs review tools

google/adk-python#7094 · 1 comment · 0 reactions · 1 assignee · Indexed Sep 16, 2026
`bypass_multi_tools_limit` on `VertexAiSearchTool` is a leaky abstraction: unexpected dependencies, silent shift from inbuilt RAG to tool calling, and prompt fragility Open

request clarification tools

google/adk-python#7100 · 2 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
RFC: context-boundary validation — provenance for untrusted tool/MCP content that can drive tool calls Open

needs review tools

google/adk-python#7103 · 2 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
Resumable flow: a parallel tool call that never executed is never replayed when a sibling call was answered Open

core

google/adk-python#7108 · 5 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
Memory has no removal path: delete_session() leaves what add_session_to_memory() copied, and BaseMemoryService exposes no way to remove it Open

core

google/adk-python#7109 · 8 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
Agents under different parents may share a name: no warning, and find_agent() silently resolves to the first Open

agent engine

google/adk-python#7110 · 3 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
BigQueryAgentAnalyticsPlugin records error-bearing tool results as TOOL_COMPLETED with status OK Open

bq needs review

google/adk-python#7112 · 3 comments · 0 reactions · 2 assignees · Indexed Sep 16, 2026

google/adk-python

Get new issues in your inbox