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

MCP session pool can grow unbounded with high-cardinality dynamic headers Open

mcp tools

google/adk-python#5959 · 1 comment · 0 reactions · 2 assignees · Indexed Sep 16, 2026
A2A sub-agent completion ends parent agent flow without returning to LLM Open

core needs review

google/adk-python#5977 · 3 comments · 0 reactions · 2 assignees · Indexed Sep 16, 2026
AgentTool: option to propagate parent conversation history to child session Open

core needs review

google/adk-python#6019 · 4 comments · 1 reaction · 1 assignee · Indexed Sep 16, 2026
[Feature] Enforce Agent output_schema for OpenAI-compatible / third-party BaseLlm providers (DeepSeek, NVIDIA NIM, etc.) Open

models needs review

google/adk-python#6021 · 4 comments · 1 reaction · 2 assignees · Indexed Sep 16, 2026
What's the purpose of logging if messages are truncated ? At least it should be configurable Open

request clarification tracing

google/adk-python#6056 · 2 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
Support Grounding Metadata / Citation Propagation in in mcp_tool class Open

mcp tools

google/adk-python#6081 · 4 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
message_as_output=True unconditionally set, destroying structured event.output for single_turn agents with output_schema Open

core needs review

google/adk-python#6089 · 2 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
Decision ledger: persist the authority, refusal, and approval behind each tool call Open

needs review spam tracing

google/adk-python#6099 · 42 comments · 0 reactions · 2 assignees · Indexed Sep 16, 2026
Keep GOOGLE_GENAI_USE_VERTEXAI as a long-term alias without runtime deprecation warnings Open

core needs review

google/adk-python#6168 · 1 comment · 0 reactions · 2 assignees · Indexed Sep 16, 2026
Document or support change-subject flow: suspend task sub-agent, handle side topic via parent and resume task branch after Open

core needs review

google/adk-python#6209 · 2 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
Feature Proposal: Native Support for Multi-Agent Group Chat (GroupChat / Dialogue Orchestration) API Open

core needs review

google/adk-python#6214 · 2 comments · 0 reactions · 2 assignees · Indexed Sep 16, 2026
Add around-call plugin hooks for durable model/tool execution Open

core needs review

google/adk-python#6224 · 1 comment · 0 reactions · 1 assignee · Indexed Sep 16, 2026
Native integration with AWS Bedrock LLMs Open

models needs review

google/adk-python#6249 · 1 comment · 0 reactions · 2 assignees · Indexed Sep 16, 2026
LoopAgent: surface the current iteration index in the event stream Open

core needs review

google/adk-python#6266 · 2 comments · 0 reactions · 2 assignees · Indexed Sep 16, 2026
Emit agent/node lifecycle events (start/finish) in runner.run_async Open

agent engine needs review

google/adk-python#6267 · 2 comments · 0 reactions · 2 assignees · Indexed Sep 16, 2026
No first-class way to serve the ADK data plane (`streamQuery`/sessions) **and** A2A 1.0 on a single Agent Engine Open

agent engine needs review

google/adk-python#6333 · 1 comment · 0 reactions · 2 assignees · Indexed Sep 16, 2026
Expose session ttl / expire_time through the api_server REST layer and get_fast_api_app Open

needs review services

google/adk-python#6342 · 2 comments · 1 reaction · 1 assignee · Indexed Sep 16, 2026
user.id silently dropped when GENERATE_CONTENT_EVENT_ONLY_EXTRA_ATTRIBUTES_CONTEXT_KEY is missing Open

needs review tracing

google/adk-python#6361 · 6 comments · 0 reactions · 2 assignees · Indexed Sep 16, 2026
Expose a public message_handler seam for MCP ClientSession (consume server notifications e.g. tools/list_changed) Open

mcp needs review spam

google/adk-python#6385 · 3 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
Dockerfile from "adk deploy agent_engine" ignores "AGENT_GATEWAY_ROOT_CERTIFICATES" build arg, causing runtime SSL handshake failures Open

agent engine needs review

google/adk-python#6427 · 5 comments · 2 reactions · 2 assignees · Indexed Sep 16, 2026
Human-in-the-loop tool confirmation is forgeable by an A2A peer (self-approves dangerous tools) Open

a2a tools

google/adk-python#6461 · 10 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
Lightweight Mock Executor for Deterministic Agent Testing Open

eval needs review

google/adk-python#6472 · 3 comments · 0 reactions · 2 assignees · Indexed Sep 16, 2026
[LiteLLM] role='tool_responses' for Gemma-4 models breaks tool calling on LM Studio (strict OpenAI role validation) Open

models request clarification

google/adk-python#6482 · 9 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
[Feature] Opt-in visibility of sibling agents' final responses across branches Open

core needs review

google/adk-python#6496 · 2 comments · 4 reactions · 2 assignees · Indexed Sep 16, 2026
Vertex AI Search Grounding Metadata not included in Gemini 3.5 response Open

models

google/adk-python#6512 · 6 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
Support MCP and other toolset tools as graph workflow nodes Open

needs review tools

google/adk-python#6533 · 2 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
[Feature Request]: Add Creduent zero-trust agent identity verification plugin for ADK Open

agent config needs review

google/adk-python#6551 · 3 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
"Failed to detach context" (Token created in a different Context) logged as ERROR when caller stops runner.run_async() early Open

needs review tracing

google/adk-python#6559 · 4 comments · 0 reactions · 2 assignees · Indexed Sep 16, 2026
[Feature Request]: Add framework-neutral agent-hooks contract to govern ADK agents Open

agent engine needs review

google/adk-python#6602 · 1 comment · 0 reactions · 1 assignee · Indexed Sep 16, 2026
Use an explicit re-export in __init__.py generated by adk create Open

core needs review

google/adk-python#6648 · 1 comment · 0 reactions · 1 assignee · Indexed Sep 16, 2026
A2A message:stream against a deployed Agent Engine (reasoningEngines) target truncates after TASK_STATE_WORKING, or fails with 'append=True for nonexistent artifact_id' Open

a2a request clarification

google/adk-python#6680 · 5 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
Evals fail with VertexAiSessionService because generated session IDs violate Agent Engine constraints Open

agent engine needs review services

google/adk-python#6683 · 3 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
ApiServer.get_fast_api_app() registers unbounded in-memory span exporters (memory leak on long-lived servers) Open

tracing

google/adk-python#6692 · 4 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
Follow-up to #4309: fix for failed A2A tasks needs both _handle_a2a_response/_v2, _compat.TS_FAILED, and error_code — still reproducible in 2.6.2 Open

a2a

google/adk-python#6708 · 3 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
A2A: 2.7.0 flattens the answer to a RELAYED human-input pause, so a remote agent can never resume (silent approval-gate bypass) Open

a2a request clarification

google/adk-python#6721 · 2 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
Proxied file uploads bypass the LiteLLM Proxy and are sent to api.openai.com Open

models request clarification

google/adk-python#6722 · 4 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
LocalEvalService discards per-invocation results for any metric reporting EvalStatus.NOT_EVALUATED -- is there an intended shape for non-pass/fail (measurement) metrics? Open

eval

google/adk-python#6725 · 2 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
Parallel ungated tool results are lost across a tool-confirmation pause, yielding an empty model reply after approval Open

agent engine request clarification

google/adk-python#6732 · 2 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
Allow validated `McpToolset` args in local YAML agents served by `adk web` Open

needs review web

google/adk-python#6735 · 2 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
LiteLLM tool call ids carry the embedded Gemini thought signature Open

models

google/adk-python#6742 · 3 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
output_schema validation dumps in pydantic python mode, so the node result is not JSON-serializable Open

core request clarification

google/adk-python#6747 · 3 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
contents rearrange still raises on id-less / unmatched trailing function responses (follow-up to orphan FR prune) Open

live

google/adk-python#6751 · 5 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
[Feature Request] Do not generate `__init__.py` for config-based agents Open

agent config needs review

google/adk-python#6753 · 3 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
2.7.0 on Agent Engine: worker dies without a traceback on the second model call after a tool round-trip, truncating the stream Open

agent engine request clarification

google/adk-python#6757 · 5 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026
feat(integrations): Add OpenSandboxEnvironment for remote sandbox workspaces Open

tools

google/adk-python#6758 · 1 comment · 0 reactions · 1 assignee · Indexed Sep 16, 2026
build_agent_card(): agent_registry cards stay streaming:false after #6673, and the streaming= parameter becomes unreachable Open

agent config needs review

google/adk-python#6778 · 4 comments · 0 reactions · 2 assignees · Indexed Sep 16, 2026
Are node-level callbacks / plugin hooks planned for graph Workflow? Open

core needs review

google/adk-python#6779 · 3 comments · 0 reactions · 2 assignees · Indexed Sep 16, 2026
MCP tool outputSchema is dropped on the LiteLLM path Open

tools

google/adk-python#6784 · 1 comment · 0 reactions · 1 assignee · Indexed Sep 16, 2026
Support custom header names for MCP servers secured with Auth Providers Open

mcp needs review

google/adk-python#6814 · 1 comment · 0 reactions · 1 assignee · Indexed Sep 16, 2026
[Feature Proposal]: adk graph - Visual Agent Inspector, Bi-directional Code Generator, & Live Debugger Open

needs review tools

google/adk-python#6817 · 5 comments · 0 reactions · 1 assignee · Indexed Sep 16, 2026

google/adk-python

Get new issues in your inbox