spring-projects/spring-ai

View on GitHub

An Application Framework for AI Engineering

Stars: 9.5k
Forks: 2.9k
Open beginner issues: 34
Indexed issues: 964
Avg merge: 1d 7h
Merged PRs (30d): 6

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

Beginner friendly Everything

Open All

65 beginner-friendly issues open

`AnthropicChatModel` makes thinking blocks the primary generation Open

status: waiting-for-triage

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

spring-projects/spring-ai#7000 · Opened Sep 15, 2026
Bump mcp.sdk.version to 2.0.1+ — unregistered/unknown JSON-RPC methods return HTTP 500 on stateless transports Open

status: waiting-for-triage

Difficulty 1/5 Under an hour Newbie friendliness 90/100

spring-projects/spring-ai#6998 · Opened Sep 15, 2026
[Bug - MCP server] @McpTool error messages are emitted twice when the thrown exception has no cause Open

status: waiting-for-triage

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

spring-projects/spring-ai#6948 · 1 comment · 1 reaction · Opened Sep 9, 2026
spring.ai.openai.chat.reasoning-effort not documented Open

status: waiting-for-triage

Difficulty 1/5 Under an hour Newbie friendliness 90/100

spring-projects/spring-ai#6940 · 1 comment · Opened Sep 8, 2026
ChunkMerger.chunkToChatCompletion throws OpenAIInvalidDataException when a streamed chunk omits `id` or `model` (only `created` is guarded) Open

status: waiting-for-triage

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

spring-projects/spring-ai#6928 · 1 comment · Opened Sep 7, 2026
RedisChatMemoryRepository auto-config backs off when any ChatMemory bean exists (ChatMemory.class in ConditionalOnMissingBean) Open

status: waiting-for-triage

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

spring-projects/spring-ai#6926 · 2 comments · Opened Sep 7, 2026
No way to set per-request HTTP headers on `GoogleGenAiChatModel` Open

status: waiting-for-triage

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

spring-projects/spring-ai#6920 · 1 comment · Opened Sep 6, 2026
`DefaultContentFormatter.Builder.from()` produces a builder that throws `UnsupportedOperationException` Open

status: waiting-for-triage

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

spring-projects/spring-ai#6911 · Opened Sep 3, 2026
`Document.mutate()` shares the metadata map with the original document Open

status: waiting-for-triage

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

spring-projects/spring-ai#6910 · Opened Sep 3, 2026
`FilterExpressionTextParser` fails to parse expressions whose first key starts with the letters `where` Open

status: waiting-for-triage

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

spring-projects/spring-ai#6909 · 1 comment · Opened Sep 3, 2026
Cassandra chat memory schema initialisation fails on native protocol V4 Open

status: waiting-for-triage

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

spring-projects/spring-ai#6877 · Opened Aug 30, 2026
docs: PZERO OpenAI-compatible chat.base-url example Open

status: waiting-for-triage

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

spring-projects/spring-ai#6873 · Opened Aug 28, 2026
Provide a built-in `ToolCallResultConverter` for plain text tool results Open

status: waiting-for-triage

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

spring-projects/spring-ai#6849 · Opened Aug 25, 2026
`JsonHelper.toJson(..., true)` treats strings with a JSON prefix as valid JSON Open

status: waiting-for-triage

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

spring-projects/spring-ai#6847 · Opened Aug 25, 2026
Kotlin `entity()` extension crashes with NullPointerException instead of returning null Open

status: waiting-for-triage

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

spring-projects/spring-ai#6826 · Opened Aug 21, 2026
`FilterExpressionTextParser` shares mutable error state across instances Open

status: waiting-for-triage

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

spring-projects/spring-ai#6807 · 1 comment · Opened Aug 17, 2026
[Bug - MCP server] Tool output schemas are not generated for primitives or "simple" types Open

status: waiting-for-triage

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

spring-projects/spring-ai#6773 · 2 comments · Opened Aug 8, 2026
`DefaultAdvisorObservationConvention` produces a span name with stray spaces Open

status: waiting-for-triage

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

spring-projects/spring-ai#6750 · 2 comments · Opened Aug 6, 2026
[Docs] Incorrect image in Upgrade Notes (Common Module Structure) Open

status: waiting-for-triage

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

spring-projects/spring-ai#6745 · 2 comments · Opened Aug 6, 2026
"$schema" is removed from elicitation requests, despite being supported since MCP 2025-11-25 Open

status: waiting-for-triage

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

spring-projects/spring-ai#6730 · Opened Aug 3, 2026
AnthropicChatModel exposes `internalStream` method publicly Open

status: waiting-for-triage

Difficulty 1/5 Under an hour Newbie friendliness 78/100

spring-projects/spring-ai#6700 · 1 comment · Opened Jul 28, 2026
ToolConfiguration input schema loses JSON property declaration order (ConverseApiUtils#convertMapToDocument uses HashMap) Open

status: waiting-for-triage

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

spring-projects/spring-ai#6696 · 1 comment · Opened Jul 27, 2026
OpenAI Transcriptions documentation page title is "Untitled" Open

status: waiting-for-triage

Difficulty 1/5 Under an hour Newbie friendliness 76/100

spring-projects/spring-ai#6691 · 1 comment · Opened Jul 26, 2026
[Bug - MCP server] Map parameter wiring for @McpPrompt is unsafe Open

status: waiting-for-triage

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

spring-projects/spring-ai#6675 · Opened Jul 23, 2026
MessageAggregator loses cacheReadInputTokens/cacheWriteInputTokens in streaming Open

status: waiting-for-triage

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

spring-projects/spring-ai#6667 · 1 comment · Opened Jul 23, 2026
[Bug] tool-callback-converter is missing from McpServerProperties Open

status: waiting-for-triage

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

spring-projects/spring-ai#6663 · 1 comment · Opened Jul 22, 2026
Google GenAI embedding: `credentials-uri` is read and silently ignored in `GoogleGenAiEmbeddingConnectionAutoConfiguration` (falls back to ADC) Open

status: waiting-for-triage

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

spring-projects/spring-ai#6644 · Opened Jul 19, 2026
Add `extraBody` field to `OpenAiEmbeddingOptions` Open

embedding openai

Difficulty 2/5 Half a day Newbie friendliness 72/100

spring-projects/spring-ai#6608 · 2 comments · Opened Jul 13, 2026
Tool Calling/Function docs leads to a 404 page Open

status: waiting-for-triage

Difficulty 1/5 Under an hour Newbie friendliness 75/100

spring-projects/spring-ai#6601 · Opened Jul 11, 2026
ParagraphPdfDocumentReader unconditionally prints PDF Table of Contents to stdout Open

status: waiting-for-triage

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

spring-projects/spring-ai#6599 · Opened Jul 11, 2026
GoogleGenAiChatAutoConfiguration builds Vertex AI credentials unscoped → invalid_scope on token refresh Open

status: waiting-for-triage

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

spring-projects/spring-ai#6595 · 1 comment · Opened Jul 10, 2026
Per-call `customHeaders` not propagated in `OpenAiEmbeddingOptions` Open

status: waiting-for-triage

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

spring-projects/spring-ai#6574 · Opened Jul 8, 2026
Support numberOfRerankedResults in BedrockKnowledgeBaseVectorStore Open

status: waiting-for-triage

Difficulty 2/5 Half a day Newbie friendliness 68/100

spring-projects/spring-ai#6569 · 1 comment · Opened Jul 7, 2026
ThinkingTagCleaner.Builder.withoutDefaultPatterns() does not disable default patterns Open

status: waiting-for-triage

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

spring-projects/spring-ai#6499 · Opened Jun 24, 2026
Add WebP image support for multimodality Open

status: waiting-for-triage

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

spring-projects/spring-ai#6474 · 1 comment · Opened Jun 20, 2026
Add CLIENT SETNAME to Valkey vector store for connection identification Open

status: waiting-for-triage

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

spring-projects/spring-ai#6172 · 2 comments · Opened May 26, 2026
ToolChoiceBuilder: REQUIRED type Open

status: waiting-for-triage

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

spring-projects/spring-ai#6120 · Opened May 22, 2026
Add missing test coverage for Bedrock Converse streaming tool-use usage aggregation Open

status: waiting-for-triage

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

spring-projects/spring-ai#6108 · Opened May 21, 2026
[DeepSeek] HTTP 400 Error in Thinking Mode: `reasoning_content` not passed back to API in multi-turn conversations Open

status: waiting-for-triage

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

spring-projects/spring-ai#6026 · 4 comments · Opened May 13, 2026
IndexOutOfBoundsException in OpenAiChatModel.internalStream when choice.index() != list position Open

status: waiting-for-triage

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

spring-projects/spring-ai#6023 · 2 comments · Opened May 13, 2026
Google GenAI Text Embedding does not pass task type to the API Open

status: waiting-for-triage

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

spring-projects/spring-ai#5966 · 1 comment · Opened May 7, 2026
McpStatelessSyncServer not initialized under spring.main.lazy-initialization=true, causing "MCP handler not configured" on every request Open

status: waiting-for-triage

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

spring-projects/spring-ai#5964 · Opened May 7, 2026
CassandraVectorStore does not close ExecutorService causing thread leak Open

status: waiting-for-triage

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

spring-projects/spring-ai#5931 · 1 comment · Opened May 4, 2026
Consolidate JSON Schema generation documentation between Tool Calling and Structured Output Conversion Open

status: waiting-for-triage

Difficulty 2/5 Half a day Newbie friendliness 68/100

spring-projects/spring-ai#5915 · Opened Apr 30, 2026
MCP server: McpServerStatelessAutoConfiguration does not pass mcpServerObjectMapper into McpServer.sync().jsonMapper() Open

status: waiting-for-triage

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

spring-projects/spring-ai#5894 · 3 comments · 3 reactions · Opened Apr 27, 2026
TikaDocumentReaderTests misparses CsvSource values containing commas in contentSnipped Open

status: waiting-for-triage

Difficulty 1/5 Under an hour Newbie friendliness 88/100

spring-projects/spring-ai#5889 · Opened Apr 26, 2026
Missing session ID in error log of WebFluxMcpSessionTransport Open

status: waiting-for-triage

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

spring-projects/spring-ai#5858 · 1 comment · Opened Apr 22, 2026
Missing Javadoc for notifyClient method in WebFluxSseServerTransportProvider Open

status: waiting-for-triage

Difficulty 1/5 Under an hour Newbie friendliness 78/100

spring-projects/spring-ai#5856 · 1 comment · Opened Apr 22, 2026
GoogleGenAiChatModel: Thought information missing in meta data v1.1.4 Open

status: waiting-for-triage

Difficulty 1/5 Under an hour Newbie friendliness 85/100

spring-projects/spring-ai#5804 · Opened Apr 15, 2026
RESPECT_JSONPROPERTY_ORDER not enabled in JsonSchemaGenerator Open

status: waiting-for-triage

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

spring-projects/spring-ai#5797 · 1 comment · Opened Apr 13, 2026

spring-projects/spring-ai

Get new issues in your inbox