org.llm4s.config

Members list

Type members

Classlikes

final case class BraveSearchToolConfig(apiKey: String, apiUrl: String, count: Int, safeSearch: String)

Configuration data for Brave Search tool.

Configuration data for Brave Search tool.

This configuration is loaded from application.conf at the edge (via Llm4sConfig) and passed to BraveSearchTool.create() when instantiating the tool.

Value parameters

apiKey

The Brave Search API key

apiUrl

The base URL for the Brave Search API (default: https://api.search.brave.com/res/v1)

count

The number of search results to return per request

safeSearch

The safe search level (off, moderate, or strict)

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class Object
trait Matchable
class Any
Show all
object ConfigKeys

Canonical environment-variable names recognised by Llm4sConfig.

Canonical environment-variable names recognised by Llm4sConfig.

All LLM4S configuration is read from environment variables (or JVM system properties with the same name). This object centralises the names to avoid typos and make grep-friendly references possible.

== Quick reference ==

  • LLM_MODEL — required; format provider/model (e.g. "openai/gpt-4o").
  • Provider API keys — required for cloud providers; see per-section comments.
  • TRACING_MODE — optional; langfuse, opentelemetry, console, or none.
  • EMBEDDING_MODEL — required when using embeddings; format provider/model.

Attributes

Supertypes
class Object
trait Matchable
class Any
Self type
ConfigKeys.type
object DefaultConfig

Default values for provider endpoints, API versions, and tracing URLs.

Default values for provider endpoints, API versions, and tracing URLs.

These constants are used as fallbacks by the config loaders when the corresponding environment variables or config keys are not set.

Attributes

Supertypes
class Object
trait Matchable
class Any
Self type
final case class DuckDuckGoSearchToolConfig(apiUrl: String)

Configuration data for DuckDuckGo Search tool.

Configuration data for DuckDuckGo Search tool.

This configuration is loaded from application.conf at the edge (via Llm4sConfig) and passed to DuckDuckGoSearchTool.create() when instantiating the tool.

Value parameters

apiUrl

The base URL for the DuckDuckGo API (default: https://api.duckduckgo.com)

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class Object
trait Matchable
class Any
Show all
final case class ExaSearchToolConfig(apiKey: String, apiUrl: String, numResults: Int, searchType: String, maxCharacters: Int)

Configuration data for Exa Search tool.

Configuration data for Exa Search tool.

Value parameters

apiKey

The Exa API key

apiUrl

Base URL (default: https://api.exa.ai)

maxCharacters

Maximum characters for text content

numResults

Number of results to return

searchType

Search type (auto, neural, fast, deep)

Attributes

Companion
object
Supertypes
trait Serializable
trait Product
trait Equals
class Object
trait Matchable
class Any
Show all

Attributes

Companion
class
Supertypes
trait Product
trait Mirror
class Object
trait Matchable
class Any
Self type
object Llm4sConfig

Application-edge configuration loader for LLM4S.

Application-edge configuration loader for LLM4S.

Reads all runtime configuration from environment variables and system properties via PureConfig. This is the single authorised entry point for configuration in application and test code — never read sys.env, System.getenv, or ConfigFactory.load() directly.

== Provider setup == Set LLM_MODEL to provider/model (e.g. "openai/gpt-4o", "anthropic/claude-sonnet-4-5-latest", "gemini/gemini-2.0-flash") and the corresponding API key environment variable. Then call provider to obtain a org.llm4s.llmconnect.config.ProviderConfig ready for org.llm4s.llmconnect.LLMConnect.getClient.

Attributes

See also

org.llm4s.config.ConfigKeys for the full list of recognised environment variable names.

Example
for {
 cfg    <- Llm4sConfig.provider()
 client <- LLMConnect.getClient(cfg)
 agent  = new Agent(client)
 state  <- agent.run("Hello", ToolRegistry.empty)
} yield state
Supertypes
class Object
trait Matchable
class Any
Self type

Loader that builds a org.llm4s.rag.permissions.SearchIndex.PgConfig from a PureConfig pureconfig.ConfigSource.

Loader that builds a org.llm4s.rag.permissions.SearchIndex.PgConfig from a PureConfig pureconfig.ConfigSource.

Reads the llm4s.rag.permissions.pg config tree to obtain PostgreSQL connection details (host, port, database, credentials) and table names used by the RAG permission-aware search index.

Typically accessed via Llm4sConfig.pgSearchIndex rather than called directly.

Attributes

Supertypes
class Object
trait Matchable
class Any
Self type