google/adk-java
An open-source, code-first Java toolkit for building, evaluating, and deploying sophisticated AI agents with flexibility and control.
Is google/adk-java beginner-friendly?
In the last 30 days, google/adk-java merged 7 of 28 pull requests from outside contributors, and its maintainers usually reply within 1 day. 2 beginner-friendly issues are open now.
- Stars
- 1.7k
- Forks
- 431
- Open beginner issues
- 2
- Indexed issues
- 58
- Avg merge
- 3d 2h
- Merged PRs (30d)
- 46
- Dominant language
- Java
- License
- Apache-2.0
- Last GitHub push
- Oct 1, 2026
- Latest indexed
- Sep 16, 2026
- Contributing guide
- Contributing guide
- Code of conduct
- Code of conduct
- Beginner labels
- help wanted
How to contribute to google/adk-java
- Read the contributing guide first: it says how the maintainers want changes proposed, tested and reviewed.
- The project ships a dev container: open it in Codespaces to get a working environment in your browser.
- Read its code of conduct: it covers issues and pull requests as well as chat.
- Pick one of the 2 open beginner-friendly issues below and comment that you want to work on it before you start.
Issues somebody may already be working on are listed last. List everything by date
-
AdkWebServer's root->dev-ui redirect breaks behind a path-stripping reverse proxyMay be free again @hemasekhar-p claimed this 42 days ago, and no pull request is open. Openneeds review
google/adk-java#1457 · 2 comments · 1 assignee ·
Maintainers usually reply within 1 day
-
RemoteA2AAgent never attaches Message.metadata() - no way to propagate any custom data to the remote agentMay be free again @hemasekhar-p claimed this 50 days ago, and no pull request is open. Openneeds review
google/adk-java#1438 · 1 comment · 1 assignee ·
Maintainers usually reply within 1 day
-
Jackson 3 switchMay be free again @hemasekhar-p claimed this 84 days ago, and no pull request is open. Openneeds review
google/adk-java#1353 · 1 comment · 1 assignee ·
Maintainers usually reply within 1 day
-
BQAA Java preview readiness tracker: correctness, lifecycle, and Python contract parityMay be free again @hemasekhar-p claimed this 97 days ago, and no pull request is open. Openneeds review
google/adk-java#1316 · 6 comments · 1 assignee ·
Maintainers usually reply within 1 day
-
ADK Java OTel spans do not expose tool-call execution correctly in Langfuse/OpenInferenceMay be free again @hemasekhar-p claimed this 131 days ago, and no pull request is open. Openneeds review
google/adk-java#1235 · 3 comments · 1 assignee ·
Maintainers usually reply within 1 day
-
Support A2A 1.0May be free again @hemasekhar-p claimed this 147 days ago, and no pull request is open. Openneeds review
google/adk-java#1194 · 4 comments · 1 assignee ·
Maintainers usually reply within 1 day
-
Unsupported model error when using Bedrock Anthropic (Claude) with MCP toolsMay be free again @hemasekhar-p claimed this 156 days ago, and no pull request is open. Openneeds review
google/adk-java#1176 · 4 comments · 1 assignee ·
Maintainers usually reply within 1 day
-
Logging: ADK should avoid logging UGC/PIIMay be free again @hemasekhar-p claimed this 175 days ago, and no pull request is open. Openneeds review
google/adk-java#1145 · 3 comments · 1 assignee ·
Maintainers usually reply within 1 day
-
Customisable Async MCP ClientMay be free again @hemasekhar-p claimed this 188 days ago, and no pull request is open. Openneeds review
google/adk-java#1089 · 3 comments · 1 assignee ·
Maintainers usually reply within 1 day
-
skills is feature, adk-java must catch up!May be free again @hemasekhar-p claimed this 222 days ago, and no pull request is open. Openneeds review
google/adk-java#924 · 3 comments · 9 reactions · 1 assignee ·
Maintainers usually reply within 1 day
-
Update EventConverter.java to populate metadata in io.a2a.spec.PartMay be free again @hemasekhar-p claimed this 222 days ago, and no pull request is open. Openneeds review
google/adk-java#898 · 4 comments · 1 assignee ·
Maintainers usually reply within 1 day
-
Custom Metadata Support In `RunConfig`May be free again @hemasekhar-p claimed this 232 days ago, and no pull request is open. Openneeds review
google/adk-java#870 · 4 comments · 1 assignee ·
Maintainers usually reply within 1 day
-
When multiple agents communicate via the A2A protocol, the invocationContext.session.state is not transformed and transmitted to the message, and SSE streaming is not supported.May be free again @hemasekhar-p claimed this 225 days ago, and no pull request is open. Openneeds review
google/adk-java#818 · 4 comments · 1 assignee ·
Maintainers usually reply within 1 day
-
Add Interactions API support to adk-javaMay be free again @hemasekhar-p claimed this 225 days ago, and no pull request is open. Openneeds review
google/adk-java#796 · 4 comments · 1 assignee ·
Maintainers usually reply within 1 day
-
Is `SessionResumptionConfig` planned to be added?May be free again @hemasekhar-p claimed this 266 days ago, and no pull request is open. Openneeds review
google/adk-java#663 · 2 comments · 1 assignee ·
Maintainers usually reply within 1 day
-
Hard-coded `new InMemoryRunner(...)` prevents injection and custom runner implementationsMay be free again @hemasekhar-p claimed this 266 days ago, and no pull request is open. Openneeds review
google/adk-java#642 · 6 comments · 5 reactions · 1 assignee ·
Maintainers usually reply within 1 day
-
adk-java: integrate AGUI in addition to spring aiMay be free again @hemasekhar-p claimed this 217 days ago, and no pull request is open. Openneeds review
google/adk-java#630 · 3 comments · 1 assignee ·
Maintainers usually reply within 1 day
-
Support @Schema annotation for Object parameters in FunctionToolMay be free again @hemasekhar-p claimed this 266 days ago, and no pull request is open. Openneeds review
google/adk-java#611 · 2 comments · 1 reaction · 1 assignee ·
Maintainers usually reply within 1 day
-
Invocation context attribute propagationMay be free again @hemasekhar-p claimed this 217 days ago, and no pull request is open. Openneeds review
google/adk-java#564 · 2 comments · 1 assignee ·
Maintainers usually reply within 1 day
-
waiting on reporter
Difficulty 5/5 Over a week Newbie friendliness 25/100
google/adk-java#516 · 1 comment ·
Maintainers usually reply within 1 day
-
Difficulty 5/5 Over a week Newbie friendliness 25/100
google/adk-java#448 · 6 comments ·
Maintainers usually reply within 1 day
-
Feature request: Support Planners in ADK JavaMay be free again @hemasekhar-p claimed this 184 days ago, and no pull request is open. Openwaiting on reporter
google/adk-java#341 · 2 comments · 1 assignee ·
Maintainers usually reply within 1 day
-
WARNING com.google.adk.web.AdkWebServer$AgentController createEvalSet Endpoint /apps/multi_tool_agent/eval_sets/evalset0bef40 (POST) is not implementedMay be free again @hemasekhar-p claimed this 152 days ago, and no pull request is open. Openneeds review
google/adk-java#300 · 7 comments · 1 assignee ·
Maintainers usually reply within 1 day
-
Unit & Integration Testing utilitiesMay be free again @vorburger claimed this 437 days ago, and no pull request is open. Opentesting
google/adk-java#289 · 3 comments · 1 assignee ·
Maintainers usually reply within 1 day
-
adk-dev capability supports rapid integration as a Spring Starter for SpringBoot AppsMay be free again @hemasekhar-p claimed this 77 days ago, and no pull request is open. Openhelp wanted needs review
google/adk-java#181 · 13 comments · 3 reactions · 1 assignee ·
Maintainers usually reply within 1 day
-
waiting on reporter
Difficulty 4/5 3-5 days Newbie friendliness 35/100
google/adk-java#116 · 11 comments · 2 reactions ·
Maintainers usually reply within 1 day
-
GeminiUtil placeholder user turn ("Continue output. DO NOT look at this line ...") is flagged by prompt injection filtersPossibly taken @innoprej claimed this today. Open
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
Maintainers usually reply within 1 day
-
[core] Client disconnects don't cancel the model stream (per-step flow is cached) — and there is no public API to cancel an in-flight runPossibly taken @hemasekhar-p claimed this 1 day ago. Openneeds review
google/adk-java#1618 · 6 comments · 1 assignee ·
Maintainers usually reply within 1 day
-
[spring-ai] Bridge drops reasoning_content (thinking) — surface it as partial events and/or persist itPossibly taken @hemasekhar-p claimed this 2 days ago. Openneeds review
google/adk-java#1616 · 1 comment · 1 assignee ·
Maintainers usually reply within 1 day
-
[spring-ai] ToolConverter silently drops enum and items from tool parameter schemasPossibly taken @hirematha claimed this 2 days ago. Openneeds review
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
google/adk-java#1609 · 2 comments · 1 assignee ·
Maintainers usually reply within 1 day
-
[spring-ai] Streaming responses ending with CJK punctuation (。!?) are misclassified as partial and never persisted to the sessionPossibly taken @hirematha claimed this 2 days ago. Openwaiting on reporter
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
google/adk-java#1608 · 2 comments · 1 assignee ·
Maintainers usually reply within 1 day
-
[FEATURE] Port bypass_multi_tools_limit for built-in search tools from adk-pythonPossibly taken @hirematha claimed this 2 days ago. Openneeds review
Difficulty 5/5 Over a week Newbie friendliness 35/100
google/adk-java#1598 · 1 comment · 1 assignee ·
Maintainers usually reply within 1 day
-
BaseLlmFlow nests each step inside the previous one and overflows the stack after a few hundred LLM callsPossibly taken @hemasekhar-p claimed this 9 days ago. Openneeds review
Difficulty 4/5 3-5 days Newbie friendliness 68/100
google/adk-java#1564 · 1 comment · 1 assignee ·
Maintainers usually reply within 1 day
-
Context caching (ContextCacheConfig) is a silent no-op: config is plumbed to InvocationContext but never readPossibly taken @hemasekhar-p claimed this 14 days ago. Openneeds review
Difficulty 5/5 Over a week Newbie friendliness 35/100
google/adk-java#1530 · 2 comments · 1 assignee ·
Maintainers usually reply within 1 day
-
MCP toolset: in-model built-ins (e.g. google_search) can be shadowed by a server tool; a server tool named set_model_response aborts the runPossibly taken @hemasekhar-p claimed this 21 days ago. Openneeds review
google/adk-java#1513 · 2 comments · 1 assignee ·
Maintainers usually reply within 1 day
-
[FEATURE] Integrating Foundgine as a Semantic Execution Layer for AI AgentsPossibly taken @hirematha claimed this 24 days ago. Openneeds review
google/adk-java#1506 · 2 comments · 1 assignee ·
Maintainers usually reply within 1 day
-
[google-adk-spring-ai] SpringAI beans are never auto-configured: @ConditionalOnBean(ChatModel) is evaluated before Spring AI model auto-configurations (missing ordering declaration)Possibly taken @hemasekhar-p claimed this 26 days ago. Openneeds review
google/adk-java#1501 · 2 comments · 1 assignee ·
Maintainers usually reply within 1 day
-
McpTool drops structuredContent and non-text content from CallToolResultPossibly taken @hemasekhar-p claimed this 47 days ago. Openneeds review waiting on reporter
google/adk-java#1443 · 2 comments · 2 assignees ·
Maintainers usually reply within 1 day
-
[FEATURE] Port DebugLoggingPlugin from adk-pythonPossibly taken @hemasekhar-p claimed this 51 days ago. Openneeds review
google/adk-java#1431 · 1 comment · 1 assignee ·
Maintainers usually reply within 1 day
-
ChatCompletionsRequest drops MCP tool parameter schemas from parametersJsonSchemaPossibly taken @hemasekhar-p claimed this 55 days ago. Openneeds review
google/adk-java#1426 · 2 comments · 1 assignee ·
Maintainers usually reply within 1 day
-
[FEATURE] Port SaveFilesAsArtifactsPlugin from adk-pythonPossibly taken @hemasekhar-p claimed this 58 days ago. Openneeds review
google/adk-java#1411 · 1 comment · 1 assignee ·
Maintainers usually reply within 1 day
-
[Feature Request] Add opt-in retry policy for transient LLM failuresPossibly taken @hemasekhar-p claimed this 64 days ago. Openneeds review
google/adk-java#1397 · 1 comment · 1 assignee ·
Maintainers usually reply within 1 day
-
[FEATURE] Port ReflectAndRetryToolPlugin from adk-pythonPossibly taken @hemasekhar-p claimed this 65 days ago. Openneeds review
google/adk-java#1390 · 1 comment · 1 assignee ·
Maintainers usually reply within 1 day
-
MCP Toolset headers are static — impossible to pass per-user JWT in multi-tenant scenariosPossibly taken @hemasekhar-p claimed this 69 days ago. Openneeds review
google/adk-java#1382 · 2 comments · 1 assignee ·
Maintainers usually reply within 1 day
-
Feature: Support third-party model strings like groq/model-id via a ServiceLoader SPIPossibly taken @hemasekhar-p claimed this 79 days ago. Openneeds review
google/adk-java#1362 · 1 comment · 1 assignee ·
Maintainers usually reply within 1 day
-
Feature Request: Run Cancellation / Abort Support for Java ADKPossibly taken @hemasekhar-p claimed this 90 days ago. Openneeds review
google/adk-java#1341 · 2 comments · 1 assignee ·
Maintainers usually reply within 1 day
-
Expose turnComplete control for ADK Java live content sendsPossibly taken @hemasekhar-p claimed this 142 days ago. Openneeds review
google/adk-java#1200 · 2 comments · 1 assignee ·
Maintainers usually reply within 1 day
-
feat: Add support for OpenAI-compatible LLM endpoints (Groq, Ollama, Azure OpenAI, etc.)Possibly taken @hemasekhar-p claimed this 142 days ago. Openneeds review
google/adk-java#1198 · 11 comments · 3 reactions · 1 assignee ·
Maintainers usually reply within 1 day
-
Telemetry: Default message content capture to falsePossibly taken @hemasekhar-p claimed this 175 days ago. Openneeds review
google/adk-java#1143 · 3 comments · 1 assignee ·
Maintainers usually reply within 1 day
-
Remove mandatory model name in LangChain4j integrationPossibly taken @hemasekhar-p claimed this 181 days ago. Openneeds review
google/adk-java#1124 · 3 comments · 1 assignee ·
Maintainers usually reply within 1 day