Class: Raix::Configuration

Inherits:
Object
  • Object
show all
Defined in:
lib/raix/configuration.rb

Overview

The Configuration class holds the configuration options for the Raix gem.

Constant Summary collapse

DEFAULT_MAX_TOKENS = 
1000
DEFAULT_MAX_COMPLETION_TOKENS = 
16_384
DEFAULT_MODEL = 
"meta-llama/llama-3.3-8b-instruct:free"
DEFAULT_MAX_TOOL_CALLS = 
25

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(fallback: nil) ⇒ Configuration

Initializes a new instance of the Configuration class with default values.

Note: temperature is intentionally not defaulted. Setting a non-nil temperature here would force it into every request payload, and some providers (e.g. Anthropic’s Claude 4.7 family on OpenRouter) do not list ‘temperature` in their supported parameters. Combined with `provider.require_parameters: true` (which Raix sets when `json: true`), an injected default of 0.0 causes OpenRouter to reject the request with “No endpoints found that can handle the requested parameters.” Callers who want a specific temperature should set one explicitly.



66
67
68
69
70
71
72
73
 
# File 'lib/raix/configuration.rb', line 66

def initialize(fallback: nil)
  self.max_completion_tokens = DEFAULT_MAX_COMPLETION_TOKENS
  self.max_tokens = DEFAULT_MAX_TOKENS
  self.model = DEFAULT_MODEL
  self.max_tool_calls = DEFAULT_MAX_TOOL_CALLS
  self.ruby_llm_config = RubyLLM.config
  self.fallback = fallback
end

Class Method Details

.attr_accessor_with_fallback(method_name) ⇒ Object 



6
7
8
9
10
11
12
13
14
15
16
17
 
# File 'lib/raix/configuration.rb', line 6

def self.attr_accessor_with_fallback(method_name)
  define_method(method_name) do
    value = instance_variable_get("@#{method_name}")
    return value if value
    return unless fallback

    fallback.public_send(method_name)
  end
  define_method("#{method_name}=") do |value|
    instance_variable_set("@#{method_name}", value)
  end
end

Instance Method Details

#client? ⇒ Boolean

Returns:

  • (Boolean) 


75
76
77
78
 
# File 'lib/raix/configuration.rb', line 75

def client?
  # Support legacy openrouter_client/openai_client or new RubyLLM config
  !!(openrouter_client || openai_client || ruby_llm_configured?)
end

#ruby_llm_configured? ⇒ Boolean

Returns:

  • (Boolean) 


80
81
82
83
 
# File 'lib/raix/configuration.rb', line 80

def ruby_llm_configured?
  ruby_llm_config&.openai_api_key || ruby_llm_config&.openrouter_api_key ||
    ruby_llm_config&.anthropic_api_key || ruby_llm_config&.gemini_api_key
end