Class: Boxcars::Engines

Inherits:
Object
  • Object
show all
Defined in:
lib/boxcars/engines.rb

Overview

Factory class for creating engine instances based on model names Provides convenient shortcuts and aliases for different AI models

Constant Summary collapse

DEFAULT_MODEL = 
"gemini-2.5-flash"

Class Method Summary collapse

Class Method Details

.engine(model: nil, **kw_args) ⇒ Boxcars::Engine

Create an engine instance based on the model name

Parameters:

  • model (String) (defaults to: nil) —

    The model name or alias

  • kw_args (Hash) —

    Additional arguments to pass to the engine

Returns:



13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
 
# File 'lib/boxcars/engines.rb', line 13

def self.engine(model: nil, **kw_args)
  model ||= Boxcars.configuration.default_model || DEFAULT_MODEL
  Boxcars.logger&.info { "running api with #{model}" }

  case model.to_s
  when /^(gpt|o\d)-/
    Boxcars::Openai.new(model:, **kw_args)
  when "anthropic", "sonnet"
    Boxcars::Anthropic.new(model: "claude-sonnet-4-0", **kw_args)
  when "opus", "claude-opus-4-0"
    Boxcars::Anthropic.new(model: "claude-opus-4-0", **kw_args)
  when /claude-/
    Boxcars::Anthropic.new(model:, **kw_args)
  when "groq", "llama-3.3-70b-versatile"
    Boxcars::Groq.new(model: "llama-3.3-70b-versatile", **kw_args)
  when "deepseek"
    Boxcars::Groq.new(model: "deepseek-r1-distill-llama-70b", **kw_args)
  when "mistral"
    Boxcars::Groq.new(model: "mistral-saba-24b", **kw_args)
  when /^mistral-/, %r{^meta-llama/}, /^deepseek-/
    Boxcars::Groq.new(model:, **kw_args)
  when "online", "sonar"
    Boxcars::Perplexityai.new(model: "sonar", **kw_args)
  when "huge", "online_huge", "sonar-huge", "sonar-pro", "sonar_pro"
    Boxcars::Perplexityai.new(model: "sonar-pro", **kw_args)
  when "flash", "gemini-flash"
    Boxcars::GeminiAi.new(model: "gemini-2.5-flash", **kw_args)
  when "gemini-pro"
    Boxcars::GeminiAi.new(model: "gemini-2.5-pro", **kw_args)
  when /gemini-/
    Boxcars::GeminiAi.new(model:, **kw_args)
  when /-sonar-/
    Boxcars::Perplexityai.new(model:, **kw_args)
  when /^together-/
    Boxcars::Together.new(model: model[9..-1], **kw_args)
  when "cerebras"
    Boxcars::Cerebras.new(model: "llama-3.3-70b", **kw_args)
  when "qwen"
    Boxcars::Together.new(model: "Qwen/Qwen2.5-VL-72B-Instruct", **kw_args)
  else
    raise Boxcars::ArgumentError, "Unknown model: #{model}"
  end
end

.json_engine(model: nil, **kw_args) ⇒ Boxcars::Engine

Create an engine instance optimized for JSON responses

Parameters:

  • model (String) (defaults to: nil) —

    The model name or alias

  • kw_args (Hash) —

    Additional arguments to pass to the engine

Returns:



61
62
63
64
65
66
67
68
 
# File 'lib/boxcars/engines.rb', line 61

def self.json_engine(model: nil, **kw_args)
  default_options = { temperature: 0.1 }
  name = model.to_s
  blocked = name.start_with?("gpt-5", "llama") || name.match?(/sonnet|opus|sonar/)
  default_options[:response_format] = { type: "json_object" } unless blocked
  options = default_options.merge(kw_args)
  engine(model:, **options)
end

.valid_answer?(answer) ⇒ Boolean

Validate that an answer has the expected structure

Parameters:

  • answer (Hash) —

    The answer to validate

Returns:

  • (Boolean) —

    True if the answer is valid



73
74
75
 
# File 'lib/boxcars/engines.rb', line 73

def self.valid_answer?(answer)
  answer.is_a?(Hash) && answer.key?(:answer) && answer[:answer].is_a?(Boxcars::Result)
end