Google Gemini

Overview

This module adds support for selected Google Gemini models.

Maven Coordinates

In addition to the Helidon integration with LangChain4j core dependencies, you must add the following:

<dependency>
    <groupId>io.helidon.integrations.langchain4j.providers</groupId>
    <artifactId>helidon-integrations-langchain4j-providers-google-gemini</artifactId>
</dependency>

Components

GoogleAiGeminiChatModel

To automatically create and add GoogleAiGeminiChatModel to the service registry add the following lines to application.yaml:

langchain4j:
  providers:
    google-gemini:
      api-key: "${GEMINI_TOKEN}"

  models:
    gemini-chat-model:
      provider: google-gemini
      model-name: "gemini-2.0-flash"

If enabled is set to false, the configuration is ignored, and the component is not created.

Configuration options

Key	Kind	Type	Default Value	Description
allow-code-execution	VALUE	Boolean		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#allowCodeExecution(java.lang.Boolean)
allow-google-maps	VALUE	Boolean		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#allowGoogleMaps(java.lang.Boolean)
allow-google-search	VALUE	Boolean		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#allowGoogleSearch(java.lang.Boolean)
allow-url-context	VALUE	Boolean		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#allowUrlContext(java.lang.Boolean)
api-key	VALUE	String		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#apiKey(java.lang.String)
base-url	VALUE	String		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#baseUrl(java.lang.String)
default-request-parameters	VALUE	d.l.m.c.r.ChatRequestParameters		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#defaultRequestParameters(dev.langchain4j.model.chat.request.ChatRequestParameters)
default-request-parameters-discover-services	VALUE	Boolean	true	Whether to enable automatic service discovery for default-request-parameters
enable-enhanced-civic-answers	VALUE	Boolean		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#enableEnhancedCivicAnswers(java.lang.Boolean)
enabled	VALUE	Boolean	true	If set to false, GoogleAiGeminiChatModel will not be available even if configured
frequency-penalty	VALUE	Double		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#frequencyPenalty(java.lang.Double)
http-client-builder	VALUE	d.l.h.c.HttpClientBuilder		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#httpClientBuilder(dev.langchain4j.http.client.HttpClientBuilder)
http-client-builder-discover-services	VALUE	Boolean	true	Whether to enable automatic service discovery for http-client-builder
include-code-execution-output	VALUE	Boolean		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#includeCodeExecutionOutput(java.lang.Boolean)
listeners	LIST	d.l.m.c.l.ChatModelListener		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#listeners(java.util.List)
listeners-discover-services	VALUE	Boolean	true	Whether to enable automatic service discovery for listeners
log-requests	VALUE	Boolean		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#logRequests(java.lang.Boolean)
log-requests-and-responses	VALUE	Boolean		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#logRequestsAndResponses(java.lang.Boolean)
log-responses	VALUE	Boolean		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#logResponses(java.lang.Boolean)
logger	VALUE	o.s.Logger		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#logger(org.slf4j.Logger)
logprobs	VALUE	Integer		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#logprobs(java.lang.Integer)
max-output-tokens	VALUE	Integer		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#maxOutputTokens(java.lang.Integer)
max-retries	VALUE	Integer		Generated from dev.langchain4j.model.googleai.GoogleAiGeminiChatModel.GoogleAiGeminiChatModelBuilder#maxRetries(java.lang.Integer)
media-resolution	VALUE	d.l.m.g.GeminiMediaResolutionLevel		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#mediaResolution(dev.langchain4j.model.googleai.GeminiMediaResolutionLevel)
media-resolution-per-part-enabled	VALUE	Boolean		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#mediaResolutionPerPartEnabled(java.lang.Boolean)
model-name	VALUE	String		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#modelName(java.lang.String)
presence-penalty	VALUE	Double		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#presencePenalty(java.lang.Double)
response-format	VALUE	d.l.m.c.r.ResponseFormat		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#responseFormat(dev.langchain4j.model.chat.request.ResponseFormat)
response-logprobs	VALUE	Boolean		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#responseLogprobs(java.lang.Boolean)
retrieve-google-maps-widget-token	VALUE	Boolean		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#retrieveGoogleMapsWidgetToken(java.lang.Boolean)
return-thinking	VALUE	Boolean		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#returnThinking(java.lang.Boolean)
safety-settings	LIST	d.l.m.g.GeminiSafetySetting		Safety setting, affecting the safety-blocking behavior
seed	VALUE	Integer		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#seed(java.lang.Integer)
send-thinking	VALUE	Boolean		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#sendThinking(java.lang.Boolean)
stop-sequences	LIST	String		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#stopSequences(java.util.List)
supported-capabilities	LIST	d.l.m.c.Capability		Generated from dev.langchain4j.model.googleai.GoogleAiGeminiChatModel.GoogleAiGeminiChatModelBuilder#supportedCapabilities(java.util.Set)
temperature	VALUE	Double		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#temperature(java.lang.Double)
thinking-config	VALUE	d.l.m.g.GeminiThinkingConfig		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#thinkingConfig(dev.langchain4j.model.googleai.GeminiThinkingConfig)
timeout	VALUE	Duration		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#timeout(java.time.Duration)
tool-config	VALUE	d.l.m.g.GeminiFunctionCallingConfig		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#toolConfig(dev.langchain4j.model.googleai.GeminiFunctionCallingConfig)
top-k	VALUE	Integer		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#topK(java.lang.Integer)
top-p	VALUE	Double		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#topP(java.lang.Double)

GoogleAiGeminiStreamingChatModel

To automatically create and add GoogleAiGeminiStreamingChatModel to the service registry add the following lines to application.yaml:

langchain4j:
  providers:
    google-gemini:
      api-key: "${GEMINI_TOKEN}"

  models:
    gemini-streaming-chat-model:
      provider: google-gemini
      model-name: "gemini-2.0-flash"

If enabled is set to false, the configuration is ignored, and the component is not created.

Configuration options

Key	Kind	Type	Default Value	Description
allow-code-execution	VALUE	Boolean		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#allowCodeExecution(java.lang.Boolean)
allow-google-maps	VALUE	Boolean		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#allowGoogleMaps(java.lang.Boolean)
allow-google-search	VALUE	Boolean		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#allowGoogleSearch(java.lang.Boolean)
allow-url-context	VALUE	Boolean		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#allowUrlContext(java.lang.Boolean)
api-key	VALUE	String		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#apiKey(java.lang.String)
base-url	VALUE	String		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#baseUrl(java.lang.String)
default-request-parameters	VALUE	d.l.m.c.r.ChatRequestParameters		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#defaultRequestParameters(dev.langchain4j.model.chat.request.ChatRequestParameters)
default-request-parameters-discover-services	VALUE	Boolean	true	Whether to enable automatic service discovery for default-request-parameters
enable-enhanced-civic-answers	VALUE	Boolean		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#enableEnhancedCivicAnswers(java.lang.Boolean)
enabled	VALUE	Boolean	true	If set to false, GoogleAiGeminiStreamingChatModel will not be available even if configured
frequency-penalty	VALUE	Double		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#frequencyPenalty(java.lang.Double)
http-client-builder	VALUE	d.l.h.c.HttpClientBuilder		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#httpClientBuilder(dev.langchain4j.http.client.HttpClientBuilder)
http-client-builder-discover-services	VALUE	Boolean	true	Whether to enable automatic service discovery for http-client-builder
include-code-execution-output	VALUE	Boolean		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#includeCodeExecutionOutput(java.lang.Boolean)
listeners	LIST	d.l.m.c.l.ChatModelListener		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#listeners(java.util.List)
listeners-discover-services	VALUE	Boolean	true	Whether to enable automatic service discovery for listeners
log-requests	VALUE	Boolean		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#logRequests(java.lang.Boolean)
log-requests-and-responses	VALUE	Boolean		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#logRequestsAndResponses(java.lang.Boolean)
log-responses	VALUE	Boolean		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#logResponses(java.lang.Boolean)
logger	VALUE	o.s.Logger		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#logger(org.slf4j.Logger)
logprobs	VALUE	Integer		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#logprobs(java.lang.Integer)
max-output-tokens	VALUE	Integer		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#maxOutputTokens(java.lang.Integer)
media-resolution	VALUE	d.l.m.g.GeminiMediaResolutionLevel		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#mediaResolution(dev.langchain4j.model.googleai.GeminiMediaResolutionLevel)
media-resolution-per-part-enabled	VALUE	Boolean		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#mediaResolutionPerPartEnabled(java.lang.Boolean)
model-name	VALUE	String		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#modelName(java.lang.String)
presence-penalty	VALUE	Double		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#presencePenalty(java.lang.Double)
response-format	VALUE	d.l.m.c.r.ResponseFormat		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#responseFormat(dev.langchain4j.model.chat.request.ResponseFormat)
response-logprobs	VALUE	Boolean		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#responseLogprobs(java.lang.Boolean)
retrieve-google-maps-widget-token	VALUE	Boolean		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#retrieveGoogleMapsWidgetToken(java.lang.Boolean)
return-thinking	VALUE	Boolean		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#returnThinking(java.lang.Boolean)
safety-settings	LIST	d.l.m.g.GeminiSafetySetting		Safety setting, affecting the safety-blocking behavior
seed	VALUE	Integer		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#seed(java.lang.Integer)
send-thinking	VALUE	Boolean		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#sendThinking(java.lang.Boolean)
stop-sequences	LIST	String		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#stopSequences(java.util.List)
temperature	VALUE	Double		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#temperature(java.lang.Double)
thinking-config	VALUE	d.l.m.g.GeminiThinkingConfig		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#thinkingConfig(dev.langchain4j.model.googleai.GeminiThinkingConfig)
timeout	VALUE	Duration		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#timeout(java.time.Duration)
tool-config	VALUE	d.l.m.g.GeminiFunctionCallingConfig		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#toolConfig(dev.langchain4j.model.googleai.GeminiFunctionCallingConfig)
top-k	VALUE	Integer		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#topK(java.lang.Integer)
top-p	VALUE	Double		Generated from dev.langchain4j.model.googleai.BaseGeminiChatModel.GoogleAiGeminiChatModelBaseBuilder#topP(java.lang.Double)

Additional Information

• LangChain4j Integration
• LangChain4j Google AI Gemini Documentation
• Google AI Gemini Website