# langchain4j/langchain4j-spring architecture

> Architecture diagram of the GitHub repository langchain4j/langchain4j-spring, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-06-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/langchain4j/langchain4j-spring
- Repository: https://github.com/langchain4j/langchain4j-spring

## Overview

1. This repository is a multi-module Maven monorepo of Spring Boot starters for LangChain4j integrations. Its purpose is to expose LangChain4j building blocks as auto-configured Spring beans, so application code can assemble AI services, models, and stores with minimal wiring.

2. The codebase is split into two parallel compatibility tracks:
   - “spring-boot-starter” modules for the older Spring Boot line
   - “spring-boot4-starter” modules for the newer Spring Boot 4 line  
   The duplication is intentional: each integration keeps its own auto-configuration and property classes per Boot generation, while preserving a similar package/module structure.

3. The central architectural layer is `langchain4j-spring-boot-starter` and `langchain4j-spring-boot4-starter`. These provide the top-level LangChain4j auto-configuration plus the AI service orchestration layer:
   - `LangChain4jAutoConfig/AutoConfiguration`
   - `AiServicesAutoConfig/AutoConfiguration`
   - scanning, wiring, and registration of `@AiService` interfaces
   - event publication such as `AiServiceRegisteredEvent`  
   This is the core boundary between Spring’s bean lifecycle and LangChain4j’s runtime service creation.

4. The AI service subsystem is responsible for turning annotated interfaces into usable service proxies. It includes:
   - classpath scanning for candidate interfaces
   - wiring mode selection for automatic vs explicit configuration
   - construction of service proxies via an `AiServiceFactory`
   - support for chat models, streaming models, tools, chat memory, retrieval augmentors, and structured output  
   The test tree shows many scenario-specific integration tests, indicating these are key behavior boundaries and not just helper utilities.

5. Retrieval-Augmented Generation is modeled as a separate but connected subsystem. There are dedicated starters for:
   - `langchain4j-rag` / `langchain4j-easy-rag`
   - retrieval and document/ingestion configuration  
   These sit upstream of AI services: documents are ingested, retrieved content is prepared, and then injected into service execution through retrieval augmentors/content retrievers.

6. Model provider integrations are organized as one starter per vendor, with near-uniform internal structure. Examples include:
   - OpenAI / OpenAI Official
   - Azure OpenAI
   - Anthropic
   - Google Gemini / Vertex AI Gemini
   - Mistral AI
   - Ollama
   - GitHub Models
   - Voyage AI  
   Each module generally contains:
   - a vendor-specific auto-configuration class
   - a root properties class
   - nested model-specific properties for chat, embedding, image, moderation, scoring, function calling, or language models  
   Architecturally, these modules adapt vendor APIs into LangChain4j model abstractions.

7. Vector store and embedding store integrations are another major subsystem. There are starters for:
   - Elasticsearch
   - Milvus
   - Azure Cosmos DB NoSQL
   - Azure Cosmos DB Mongo VCore
   - Azure AI Search  
   These modules expose embedding store beans and vendor/client configuration so retrieval and persistence layers can store vectors or search indexed embeddings. They are downstream of embedding models and upstream of RAG/retrieval flows.

8. The HTTP client layer is separated as a reusable adapter module:
   - `langchain4j-http-client-spring-restclient`
   - `langchain4j-http-client-spring-boot4-restclient`  
   These provide a Spring-based `HttpClientBuilderFactory` implementation via Java service loading (`META-INF/services`), letting LangChain4j use Spring’s REST client infrastructure without each model starter reimplementing HTTP concerns.

9. The `langchain4j-reactor` module is a small but important reactive bridge. It adapts token streams into Reactor `Flux` via `TokenStreamToFluxAdapter`, also exposed through service-provider registration. This makes streaming AI output compatible with reactive Spring applications.

10. Each starter follows the same mechanical pattern:
    - a package-scoped auto-configuration class
    - one root properties holder plus nested per-capability property classes
    - `META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports` for Spring Boot auto-discovery
    - integration tests that load a Spring context and verify the wiring  
    This consistency is what makes the architecture diagram easy to reason about: same pattern, different integration targets.

11. The test modules are not incidental; they act as executable architecture documentation. They cover auto-configuration, container-backed integrations, streaming, tool injection, conflicting bean scenarios, package scanning, and multiple service wiring modes. Several integration tests imply external dependencies such as Elasticsearch, and the repo uses Spring Boot test support heavily.

12. Build and delivery are managed at the monorepo level. The root `pom.xml`, Maven wrapper, and GitHub Actions workflows handle:
    - CI validation
    - release and snapshot publishing
    - version update automation  
    This supports a publishable starter ecosystem rather than a single application runtime.

13. In an architecture diagram, the main flow is: application code declares Spring properties and `@AiService` interfaces → Spring Boot auto-configures provider clients/models/stores → LangChain4j service factories assemble proxies and retrieval/tooling components → requests flow to external AI/vector/search services → streaming/reactive adapters and events integrate results back into the app.

14. The key boundary to emphasize is that this repo does not implement AI features itself; it wires LangChain4j abstractions into Spring Boot conventions. Vendor modules own provider-specific configuration, while the core starter owns service discovery and orchestration across all integrations.

Main entry points: [`langchain4j-spring-boot-starter/src/main/java/dev/langchain4j/service/spring/AiServicesAutoConfig.java`](https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-spring-boot-starter/src/main/java/dev/langchain4j/service/spring/AiServicesAutoConfig.java) (AI Services), [`langchain4j-spring-boot-starter/src/main/java/dev/langchain4j/rag/spring/RagAutoConfig.java`](https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-spring-boot-starter/src/main/java/dev/langchain4j/rag/spring/RagAutoConfig.java) (RAG), [`langchain4j-spring-boot4-starter/src/main/java/dev/langchain4j/service/spring/AiServicesAutoConfiguration.java`](https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-spring-boot4-starter/src/main/java/dev/langchain4j/service/spring/AiServicesAutoConfiguration.java) (AI Services 4), [`langchain4j-reactor/src/main/java/dev/langchain4j/reactor/TokenStreamToFluxAdapter.java`](https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-reactor/src/main/java/dev/langchain4j/reactor/TokenStreamToFluxAdapter.java) (Reactor Bridge)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_repo_root["Monorepo"]
  node_root_pom["Root POM<br/>build/monorepo<br/>[pom.xml]"]
  node_mvnw["Maven Wrapper<br/>build tool"]
  node_ci_workflows["CI Workflows<br/>delivery pipeline<br/>[main.yaml]"]
end

subgraph group_core["Core Spring"]
  node_langchain4j_boot["Spring Boot 3<br/>core starter"]
  node_langchain4j_boot4["Spring Boot 4<br/>core starter"]
  node_ai_services_boot["AI Services<br/>service orchestration"]
  node_ai_services_boot4["AI Services 4<br/>service orchestration"]
  node_rag_boot["RAG<br/>retrieval wiring<br/>[RagAutoConfig.java]"]
  node_rag_boot4["RAG 4<br/>retrieval wiring"]
end

subgraph group_models["Model Starters"]
  node_openai["OpenAI<br/>vendor starter<br/>[AutoConfig.java]"]
  node_openai4["OpenAI 4<br/>vendor starter"]
  node_azure_openai["Azure OpenAI<br/>vendor starter<br/>[AutoConfig.java]"]
  node_anthropic["Anthropic<br/>vendor starter<br/>[AutoConfig.java]"]
  node_gemini["Gemini<br/>vendor starter<br/>[AutoConfig.java]"]
  node_mistral["Mistral AI<br/>vendor starter<br/>[AutoConfig.java]"]
  node_ollama["Ollama<br/>vendor starter<br/>[AutoConfig.java]"]
  node_github_models["GitHub Models<br/>vendor starter<br/>[AutoConfig.java]"]
  node_vertex_gemini["Vertex Gemini<br/>vendor starter<br/>[AutoConfig.java]"]
  node_voyage["Voyage AI<br/>vendor starter<br/>[AutoConfig.java]"]
end

subgraph group_stores["Storage Starters"]
  node_elasticsearch_store[("Elasticsearch Store<br/>embedding store")]
  node_milvus_store[("Milvus Store<br/>embedding store")]
  node_cosmos_nosql_store[("Cosmos NoSQL<br/>embedding store")]
  node_cosmos_mongo_store[("Cosmos Mongo<br/>embedding store")]
  node_azure_ai_search_store[("Azure AI Search<br/>search store<br/>[AutoConfig.java]")]
end

subgraph group_adapters["Adapters"]
  node_http_restclient["Spring RestClient<br/>http adapter"]
  node_http_restclient4["Spring RestClient 4<br/>http adapter"]
  node_reactor_bridge["Reactor Bridge<br/>reactive adapter"]
end

node_root_pom -->|"builds"| node_langchain4j_boot
node_root_pom -->|"builds"| node_langchain4j_boot4
node_root_pom -->|"delivers"| node_ci_workflows
node_langchain4j_boot -->|"orchestrates"| node_ai_services_boot
node_langchain4j_boot -->|"provides"| node_rag_boot
node_langchain4j_boot4 -->|"orchestrates"| node_ai_services_boot4
node_langchain4j_boot4 -->|"provides"| node_rag_boot4
node_ai_services_boot -->|"uses models"| node_openai
node_ai_services_boot -->|"uses models"| node_anthropic
node_ai_services_boot -->|"uses models"| node_gemini
node_ai_services_boot -->|"uses models"| node_mistral
node_ai_services_boot -->|"uses models"| node_ollama
node_ai_services_boot -->|"uses models"| node_github_models
node_ai_services_boot -->|"uses models"| node_vertex_gemini
node_ai_services_boot -->|"uses models"| node_voyage
node_ai_services_boot -->|"retrieves from"| node_elasticsearch_store
node_ai_services_boot -->|"retrieves from"| node_azure_ai_search_store
node_ai_services_boot -->|"streams via"| node_reactor_bridge
node_ai_services_boot4 -->|"uses models"| node_openai4
node_ai_services_boot4 -->|"uses models"| node_azure_openai
node_ai_services_boot4 -->|"streams via"| node_reactor_bridge
node_rag_boot -->|"indexes into"| node_elasticsearch_store
node_rag_boot -->|"indexes into"| node_milvus_store
node_rag_boot -->|"indexes into"| node_cosmos_nosql_store
node_rag_boot -->|"indexes into"| node_cosmos_mongo_store
node_rag_boot -->|"indexes into"| node_azure_ai_search_store
node_rag_boot4 -->|"indexes into"| node_elasticsearch_store
node_rag_boot4 -->|"indexes into"| node_azure_ai_search_store
node_http_restclient -.->|"supports"| node_openai
node_http_restclient -.->|"supports"| node_anthropic
node_http_restclient4 -.->|"supports"| node_openai4
node_http_restclient4 -.->|"supports"| node_azure_openai
node_reactor_bridge -->|"adapts"| node_ai_services_boot
node_reactor_bridge -->|"adapts"| node_ai_services_boot4

click node_root_pom "https://github.com/langchain4j/langchain4j-spring/blob/main/pom.xml"
click node_mvnw "https://github.com/langchain4j/langchain4j-spring/tree/main/mvnw"
click node_ci_workflows "https://github.com/langchain4j/langchain4j-spring/blob/main/.github/workflows/main.yaml"
click node_langchain4j_boot "https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-spring-boot-starter/src/main/java/dev/langchain4j/spring/LangChain4jAutoConfig.java"
click node_langchain4j_boot4 "https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-spring-boot4-starter/src/main/java/dev/langchain4j/spring/LangChain4jAutoConfiguration.java"
click node_ai_services_boot "https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-spring-boot-starter/src/main/java/dev/langchain4j/service/spring/AiServicesAutoConfig.java"
click node_ai_services_boot4 "https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-spring-boot4-starter/src/main/java/dev/langchain4j/service/spring/AiServicesAutoConfiguration.java"
click node_rag_boot "https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-spring-boot-starter/src/main/java/dev/langchain4j/rag/spring/RagAutoConfig.java"
click node_rag_boot4 "https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-spring-boot4-starter/src/main/java/dev/langchain4j/rag/spring/RagAutoConfiguration.java"
click node_openai "https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-open-ai-spring-boot-starter/src/main/java/dev/langchain4j/openai/spring/AutoConfig.java"
click node_openai4 "https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-open-ai-spring-boot4-starter/src/main/java/dev/langchain4j/openai/spring/OpenAiAutoConfiguration.java"
click node_azure_openai "https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-azure-open-ai-spring-boot-starter/src/main/java/dev/langchain4j/azure/openai/spring/AutoConfig.java"
click node_anthropic "https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-anthropic-spring-boot-starter/src/main/java/dev/langchain4j/anthropic/spring/AutoConfig.java"
click node_gemini "https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-google-ai-gemini-spring-boot-starter/src/main/java/dev/langchain4j/googleaigemini/spring/AutoConfig.java"
click node_mistral "https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-mistral-ai-spring-boot-starter/src/main/java/dev/langchain4j/mistralai/spring/AutoConfig.java"
click node_ollama "https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-ollama-spring-boot-starter/src/main/java/dev/langchain4j/ollama/spring/AutoConfig.java"
click node_github_models "https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-github-models-spring-boot-starter/src/main/java/dev/langchain4j/model/githubmodels/spring/AutoConfig.java"
click node_vertex_gemini "https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-vertex-ai-gemini-spring-boot-starter/src/main/java/dev/langchain4j/vertexai/gemini/spring/AutoConfig.java"
click node_voyage "https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-voyage-ai-spring-boot-starter/src/main/java/dev/langchain4j/voyageai/spring/AutoConfig.java"
click node_elasticsearch_store "https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-elasticsearch-spring-boot-starter/src/main/java/dev/langchain4j/store/embedding/elasticsearch/spring/ElasticsearchEmbeddingStoreAutoConfiguration.java"
click node_milvus_store "https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-milvus-spring-boot-starter/src/main/java/dev/langchain4j/store/embedding/milvus/spring/MilvusEmbeddingStoreAutoConfiguration.java"
click node_cosmos_nosql_store "https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-azure-cosmos-nosql-spring-boot-starter/src/main/java/dev/langchain4j/store/embedding/azure/cosmos/nosql/spring/AzureCosmosDbNoSqlEmbeddingStoreAutoConfiguration.java"
click node_cosmos_mongo_store "https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-azure-cosmos-mongo-vcore-spring-boot-starter/src/main/java/dev/langchain4j/store/embedding/azure/cosmos/mongo/vcore/spring/AzureCosmosDbMongoVCoreEmbeddingStoreAutoConfiguration.java"
click node_azure_ai_search_store "https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-azure-ai-search-spring-boot-starter/src/main/java/dev/langchain4j/azure/aisearch/spring/AutoConfig.java"
click node_http_restclient "https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-http-client-spring-restclient/src/main/java/dev/langchain4j/http/client/spring/restclient/SpringRestClientBuilderFactory.java"
click node_http_restclient4 "https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-http-client-spring-boot4-restclient/src/main/java/dev/langchain4j/http/client/spring/restclient/SpringRestClientBuilderFactory.java"
click node_reactor_bridge "https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-reactor/src/main/java/dev/langchain4j/reactor/TokenStreamToFluxAdapter.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_root_pom,node_mvnw,node_ci_workflows toneBlue
class node_langchain4j_boot,node_langchain4j_boot4,node_ai_services_boot,node_ai_services_boot4,node_rag_boot,node_rag_boot4 toneAmber
class node_openai,node_openai4,node_azure_openai,node_anthropic,node_gemini,node_mistral,node_ollama,node_github_models,node_vertex_gemini,node_voyage toneMint
class node_elasticsearch_store,node_milvus_store,node_cosmos_nosql_store,node_cosmos_mongo_store,node_azure_ai_search_store toneRose
class node_http_restclient,node_http_restclient4,node_reactor_bridge toneIndigo
```

## Components

### Monorepo

Maven multi-module starter ecosystem and delivery wiring

- [Root POM](https://github.com/langchain4j/langchain4j-spring/blob/main/pom.xml): build/monorepo · Aggregates all starter modules and manages release packaging · `pom.xml`
- [Maven Wrapper](https://github.com/langchain4j/langchain4j-spring/tree/main/mvnw): build tool · Pinned Maven bootstrap for local and CI builds · `mvnw`
- [CI Workflows](https://github.com/langchain4j/langchain4j-spring/blob/main/.github/workflows/main.yaml): delivery pipeline · Validation, release, snapshot publishing, and version automation · `.github/workflows/main.yaml`

### Core Spring

Shared LangChain4j service orchestration and RAG wiring

- [Spring Boot 3](https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-spring-boot-starter/src/main/java/dev/langchain4j/spring/LangChain4jAutoConfig.java): core starter · Auto-configuration boundary for LangChain4j services and RAG · `langchain4j-spring-boot-starter/src/main/java/dev/langchain4j/spring/LangChain4jAutoConfig.java`
- [Spring Boot 4](https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-spring-boot4-starter/src/main/java/dev/langchain4j/spring/LangChain4jAutoConfiguration.java): core starter · Boot 4 variant of the LangChain4j core orchestration layer · `langchain4j-spring-boot4-starter/src/main/java/dev/langchain4j/spring/LangChain4jAutoConfiguration.java`
- [AI Services](https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-spring-boot-starter/src/main/java/dev/langchain4j/service/spring/AiServicesAutoConfig.java): service orchestration · Scans @AiService interfaces and assembles service proxies · `langchain4j-spring-boot-starter/src/main/java/dev/langchain4j/service/spring/AiServicesAutoConfig.java`
- [AI Services 4](https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-spring-boot4-starter/src/main/java/dev/langchain4j/service/spring/AiServicesAutoConfiguration.java): service orchestration · Boot 4 AI service scanner and proxy factory wiring · `langchain4j-spring-boot4-starter/src/main/java/dev/langchain4j/service/spring/AiServicesAutoConfiguration.java`
- [RAG](https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-spring-boot-starter/src/main/java/dev/langchain4j/rag/spring/RagAutoConfig.java): retrieval wiring · Retrieval augmentation and ingestion properties for service execution · `langchain4j-spring-boot-starter/src/main/java/dev/langchain4j/rag/spring/RagAutoConfig.java`
- [RAG 4](https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-spring-boot4-starter/src/main/java/dev/langchain4j/rag/spring/RagAutoConfiguration.java): retrieval wiring · Boot 4 retrieval augmentation configuration · `langchain4j-spring-boot4-starter/src/main/java/dev/langchain4j/rag/spring/RagAutoConfiguration.java`

### Model Starters

Vendor adapters that expose chat, embedding, image, moderation, and scoring beans

- [OpenAI](https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-open-ai-spring-boot-starter/src/main/java/dev/langchain4j/openai/spring/AutoConfig.java): vendor starter · OpenAI chat, embedding, image, language, and moderation properties · `langchain4j-open-ai-spring-boot-starter/src/main/java/dev/langchain4j/openai/spring/AutoConfig.java`
- [OpenAI 4](https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-open-ai-spring-boot4-starter/src/main/java/dev/langchain4j/openai/spring/OpenAiAutoConfiguration.java): vendor starter · Boot 4 OpenAI integration and model properties · `langchain4j-open-ai-spring-boot4-starter/src/main/java/dev/langchain4j/openai/spring/OpenAiAutoConfiguration.java`
- [Azure OpenAI](https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-azure-open-ai-spring-boot-starter/src/main/java/dev/langchain4j/azure/openai/spring/AutoConfig.java): vendor starter · Azure OpenAI chat, embedding, and image wiring · `langchain4j-azure-open-ai-spring-boot-starter/src/main/java/dev/langchain4j/azure/openai/spring/AutoConfig.java`
- [Anthropic](https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-anthropic-spring-boot-starter/src/main/java/dev/langchain4j/anthropic/spring/AutoConfig.java): vendor starter · Anthropic chat model properties and auto-configuration · `langchain4j-anthropic-spring-boot-starter/src/main/java/dev/langchain4j/anthropic/spring/AutoConfig.java`
- [Gemini](https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-google-ai-gemini-spring-boot-starter/src/main/java/dev/langchain4j/googleaigemini/spring/AutoConfig.java): vendor starter · Google AI Gemini chat, embedding, and function-calling wiring · `langchain4j-google-ai-gemini-spring-boot-starter/src/main/java/dev/langchain4j/googleaigemini/spring/AutoConfig.java`
- [Mistral AI](https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-mistral-ai-spring-boot-starter/src/main/java/dev/langchain4j/mistralai/spring/AutoConfig.java): vendor starter · Mistral chat, embedding, fim, and moderation wiring · `langchain4j-mistral-ai-spring-boot-starter/src/main/java/dev/langchain4j/mistralai/spring/AutoConfig.java`
- [Ollama](https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-ollama-spring-boot-starter/src/main/java/dev/langchain4j/ollama/spring/AutoConfig.java): vendor starter · Local Ollama chat, embedding, and language model properties · `langchain4j-ollama-spring-boot-starter/src/main/java/dev/langchain4j/ollama/spring/AutoConfig.java`
- [GitHub Models](https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-github-models-spring-boot-starter/src/main/java/dev/langchain4j/model/githubmodels/spring/AutoConfig.java): vendor starter · GitHub Models chat and embedding integration · `langchain4j-github-models-spring-boot-starter/src/main/java/dev/langchain4j/model/githubmodels/spring/AutoConfig.java`
- [Vertex Gemini](https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-vertex-ai-gemini-spring-boot-starter/src/main/java/dev/langchain4j/vertexai/gemini/spring/AutoConfig.java): vendor starter · Vertex AI Gemini chat integration · `langchain4j-vertex-ai-gemini-spring-boot-starter/src/main/java/dev/langchain4j/vertexai/gemini/spring/AutoConfig.java`
- [Voyage AI](https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-voyage-ai-spring-boot-starter/src/main/java/dev/langchain4j/voyageai/spring/AutoConfig.java): vendor starter · Voyage embedding and scoring model wiring · `langchain4j-voyage-ai-spring-boot-starter/src/main/java/dev/langchain4j/voyageai/spring/AutoConfig.java`

### Storage Starters

Embedding store and retrieval backends for vector persistence and search

- [Elasticsearch Store](https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-elasticsearch-spring-boot-starter/src/main/java/dev/langchain4j/store/embedding/elasticsearch/spring/ElasticsearchEmbeddingStoreAutoConfiguration.java): embedding store · Embedding store backed by Elasticsearch client configuration · `langchain4j-elasticsearch-spring-boot-starter/src/main/java/dev/langchain4j/store/embedding/elasticsearch/spring/ElasticsearchEmbeddingStoreAutoConfiguration.java`
- [Milvus Store](https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-milvus-spring-boot-starter/src/main/java/dev/langchain4j/store/embedding/milvus/spring/MilvusEmbeddingStoreAutoConfiguration.java): embedding store · Milvus-backed vector persistence starter · `langchain4j-milvus-spring-boot-starter/src/main/java/dev/langchain4j/store/embedding/milvus/spring/MilvusEmbeddingStoreAutoConfiguration.java`
- [Cosmos NoSQL](https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-azure-cosmos-nosql-spring-boot-starter/src/main/java/dev/langchain4j/store/embedding/azure/cosmos/nosql/spring/AzureCosmosDbNoSqlEmbeddingStoreAutoConfiguration.java): embedding store · Azure Cosmos DB NoSQL embedding store integration · `langchain4j-azure-cosmos-nosql-spring-boot-starter/src/main/java/dev/langchain4j/store/embedding/azure/cosmos/nosql/spring/AzureCosmosDbNoSqlEmbeddingStoreAutoConfiguration.java`
- [Cosmos Mongo](https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-azure-cosmos-mongo-vcore-spring-boot-starter/src/main/java/dev/langchain4j/store/embedding/azure/cosmos/mongo/vcore/spring/AzureCosmosDbMongoVCoreEmbeddingStoreAutoConfiguration.java): embedding store · Azure Cosmos DB Mongo VCore embedding store integration · `langchain4j-azure-cosmos-mongo-vcore-spring-boot-starter/src/main/java/dev/langchain4j/store/embedding/azure/cosmos/mongo/vcore/spring/AzureCosmosDbMongoVCoreEmbeddingStoreAutoConfiguration.java`
- [Azure AI Search](https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-azure-ai-search-spring-boot-starter/src/main/java/dev/langchain4j/azure/aisearch/spring/AutoConfig.java): search store · Search-backed retrieval and embedding storage starter · `langchain4j-azure-ai-search-spring-boot-starter/src/main/java/dev/langchain4j/azure/aisearch/spring/AutoConfig.java`

### Adapters

Reusable HTTP and reactive bridges used by starters and applications

- [Spring RestClient](https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-http-client-spring-restclient/src/main/java/dev/langchain4j/http/client/spring/restclient/SpringRestClientBuilderFactory.java): http adapter · Spring REST client adapter loaded through service provider registration · `langchain4j-http-client-spring-restclient/src/main/java/dev/langchain4j/http/client/spring/restclient/SpringRestClientBuilderFactory.java`
- [Spring RestClient 4](https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-http-client-spring-boot4-restclient/src/main/java/dev/langchain4j/http/client/spring/restclient/SpringRestClientBuilderFactory.java): http adapter · Boot 4 REST client adapter for LangChain4j HTTP clients · `langchain4j-http-client-spring-boot4-restclient/src/main/java/dev/langchain4j/http/client/spring/restclient/SpringRestClientBuilderFactory.java`
- [Reactor Bridge](https://github.com/langchain4j/langchain4j-spring/blob/main/langchain4j-reactor/src/main/java/dev/langchain4j/reactor/TokenStreamToFluxAdapter.java): reactive adapter · Converts token streams into Reactor Flux for streaming apps · `langchain4j-reactor/src/main/java/dev/langchain4j/reactor/TokenStreamToFluxAdapter.java`

## Connections

- Root POM → Spring Boot 3: builds · Root reactor includes the Boot 3 core starter
- Root POM → Spring Boot 4: builds · Root reactor includes the Boot 4 core starter
- Root POM → CI Workflows: delivers · CI and release workflows publish artifacts
- Spring Boot 3 → AI Services: orchestrates · Core starter enables AI service scanning and proxy creation
- Spring Boot 3 → RAG: provides · Core starter exposes retrieval augmentation wiring
- Spring Boot 4 → AI Services 4: orchestrates · Boot 4 core starter enables AI service scanning and proxy creation
- Spring Boot 4 → RAG 4: provides · Boot 4 core starter exposes retrieval augmentation wiring
- AI Services → OpenAI: uses models · AI services consume vendor model beans
- AI Services → Anthropic: uses models · AI services consume vendor model beans
- AI Services → Gemini: uses models · AI services consume vendor model beans
- AI Services → Mistral AI: uses models · AI services consume vendor model beans
- AI Services → Ollama: uses models · AI services consume vendor model beans
- AI Services → GitHub Models: uses models · AI services consume vendor model beans
- AI Services → Vertex Gemini: uses models · AI services consume vendor model beans
- AI Services → Voyage AI: uses models · AI services can use scoring and embedding support
- AI Services → Elasticsearch Store: retrieves from · Retrieval augmentors can consult embedding stores
- AI Services → Azure AI Search: retrieves from · Retrieval augmentors can consult search-backed stores
- AI Services → Reactor Bridge: streams via · Streaming AI service output can be bridged to Reactor
- AI Services 4 → OpenAI 4: uses models · Boot 4 AI services consume vendor model beans
- AI Services 4 → Azure OpenAI: uses models · Boot 4 AI services consume vendor model beans
- AI Services 4 → Reactor Bridge: streams via · Streaming AI service output can be bridged to Reactor
- RAG → Elasticsearch Store: indexes into · RAG ingestion persists vectors in stores
- RAG → Milvus Store: indexes into · RAG ingestion persists vectors in stores
- RAG → Cosmos NoSQL: indexes into · RAG ingestion persists vectors in stores
- RAG → Cosmos Mongo: indexes into · RAG ingestion persists vectors in stores
- RAG → Azure AI Search: indexes into · RAG can use search as a retrieval backend
- RAG 4 → Elasticsearch Store: indexes into · Boot 4 RAG ingestion persists vectors in stores
- RAG 4 → Azure AI Search: indexes into · Boot 4 RAG can use search as a retrieval backend
- Spring RestClient → OpenAI: supports · Shared HTTP adapter is reused by provider clients
- Spring RestClient → Anthropic: supports · Shared HTTP adapter is reused by provider clients
- Spring RestClient 4 → OpenAI 4: supports · Boot 4 HTTP adapter is reused by provider clients
- Spring RestClient 4 → Azure OpenAI: supports · Boot 4 HTTP adapter is reused by provider clients
- Reactor Bridge → AI Services: adapts · Reactive token streaming feeds AI service consumers
- Reactor Bridge → AI Services 4: adapts · Reactive token streaming feeds AI service consumers
