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.6k
Forks: 4k
Open beginner issues: 1
Indexed issues: 271
Avg merge: 13h 49m
Merged PRs (30d): 10

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

Beginner friendly Everything

Open All

258 open issues indexed

LLM-as-judge default config triggers google-genai's AFC warning in every eval run Open

Difficulty 1/5 1-3 hours Newbie friendliness 86/100

google/adk-python#7146 · 1 comment · Opened Sep 16, 2026
set_model_response is missing from the MCP _RESERVED_TOOL_NAMES guard Open

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

google/adk-python#7144 · Opened Sep 16, 2026
Runner.run_async keeps a caller-chosen Content.role on inbound messages; only the A2A route canonicalizes roles Open

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

google/adk-python#7142 · Opened Sep 16, 2026
RemoteA2aAgent enforces HTTPS for agent cards, blocking plaintext A2A inside a service mesh (mTLS) Open

request clarification

google/adk-python#7139 · 2 comments · 1 assignee · Opened Sep 16, 2026
feat(agent_registry): the Console code snippet uses AgentRegistry(project=...).published_skills.get(name=...), which does not exist in ADK Open

agent config

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

google/adk-python#7137 · 1 comment · Opened Sep 16, 2026
GCPSkillRegistry rejects every Google-published skill: dotted ids (cloud.google.com-*) fail name validation in get_skill and search_skills Open

tools

google/adk-python#7136 · 1 comment · 1 assignee · Opened Sep 16, 2026
feat(environment): stream lines in ReadFileTool to prevent OOM on large files Open

tools

google/adk-python#7131 · 1 comment · 1 assignee · Opened Sep 16, 2026
feat(skills): let SkillToolset pin registry skills so they appear in list_skills / the catalog without a search_skills turn Open

needs review tools

google/adk-python#7130 · 4 comments · 1 assignee · Opened Sep 16, 2026
Conformance testing produces `AttributeError: 'NoneType' object has no attribute 'recordings'` Open

core request clarification

google/adk-python#7128 · 2 comments · 1 assignee · Opened Sep 15, 2026
BigQueryAgentAnalyticsPlugin records error-bearing tool results as TOOL_COMPLETED with status OK Open

bq needs review

google/adk-python#7112 · 3 comments · 2 assignees · Opened Sep 13, 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 · 1 assignee · Opened Sep 13, 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 · 1 assignee · Opened Sep 13, 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 · 1 assignee · Opened Sep 13, 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 · 1 assignee · Opened Sep 13, 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 · 1 assignee · Opened Sep 12, 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 · 1 assignee · Opened Sep 11, 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 · 1 assignee · Opened Sep 10, 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 · 1 assignee · Opened Sep 9, 2026
Resumable mode dispatches caller-authored function calls with no model turn or author check Open

agent engine

google/adk-python#7076 · 2 comments · 1 assignee · Opened Sep 9, 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 · 1 assignee · Opened Sep 9, 2026
RestApiTool path parameters with '.' / '..' still reach the wire after quote(safe="") Open

tools

google/adk-python#7065 · 4 comments · 1 assignee · Opened Sep 9, 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 · 1 assignee · Opened Sep 8, 2026
adk web GET/DELETE test endpoints skip the create_test path sanitiser Open

request clarification web

google/adk-python#7033 · 5 comments · 1 assignee · Opened Sep 6, 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 · 1 assignee · Opened Sep 6, 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 · 1 assignee · Opened Sep 6, 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 · 1 assignee · Opened Sep 5, 2026
Proposal: Add SnowflakeCortexAgent as a BaseAgent adapter Open

models needs review

google/adk-python#7014 · 3 comments · 1 assignee · Opened Sep 4, 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 · 1 assignee · Opened Sep 4, 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 · 1 assignee · Opened Sep 4, 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 · 1 assignee · Opened Sep 3, 2026
RestApiTool silently sends an empty request body when the OpenAPI schema uses oneOf/anyOf/allOf Open

tools

google/adk-python#6991 · 4 comments · 1 assignee · Opened Sep 2, 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 · 1 assignee · Opened Sep 2, 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 · 1 assignee · Opened Sep 1, 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 · 1 assignee · Opened Sep 1, 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 · 2 assignees · Opened Sep 1, 2026
[Feature Request]: Expose current callback hook metadata in Context Open

core needs review

google/adk-python#6979 · 1 comment · 1 reaction · 1 assignee · Opened Sep 1, 2026
IntEnum tool parameters produce an invalid function declaration: integer values in a STRING enum Open

tools

google/adk-python#6978 · 5 comments · 1 assignee · Opened Sep 1, 2026
feat(model_armor): screen tool output in ModelArmorPlugin (or companion plugin) Open

models needs review spam

google/adk-python#6966 · 4 comments · 1 assignee · Opened Aug 31, 2026
sample: Model Armor tool-output screening via after_tool_callback Open

needs review tools

google/adk-python#6964 · 1 comment · 1 assignee · Opened Aug 31, 2026
[BUG]: LiteLlm.capabilities hardcodes output_schema_and_tools=True, bypassing the SetModelResponseTool workaround Open

models

google/adk-python#6954 · 4 comments · 1 assignee · Opened Aug 30, 2026
No way to delete memories from a MemoryService Open

needs review services

google/adk-python#6949 · 3 comments · 1 assignee · Opened Aug 30, 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 · 2 assignees · Opened Aug 29, 2026
Dockerfile should first copy requirements.txt and install dependencies before copying agent code Open

needs review services

google/adk-python#6923 · 4 comments · 2 assignees · Opened Aug 27, 2026
AgentCoreSessionService extending BaseSessionService for AgentCore Memory Open

agent engine needs review

google/adk-python#6920 · 4 comments · 1 assignee · Opened Aug 26, 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 · 1 assignee · Opened Aug 26, 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 · Opened Aug 26, 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 · 1 assignee · Opened Aug 24, 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 · 1 assignee · Opened Aug 24, 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 · Opened Aug 24, 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 · Opened Aug 24, 2026

google/adk-python

Get new issues in your inbox