Class: Legion::Extensions::Llm::Ollama::Provider

Inherits:
Provider
  • Object
show all
Includes:
Logging::Helper
Defined in:
lib/legion/extensions/llm/ollama/provider.rb

Overview

Ollama provider implementation for the Legion::Extensions::Llm base provider contract.

Defined Under Namespace

Modules: Capabilities

Class Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Class Attribute Details

.registry_publisher ⇒ Object 



25
26
27
 
# File 'lib/legion/extensions/llm/ollama/provider.rb', line 25

def registry_publisher
  @registry_publisher ||= Ollama.registry_publisher
end

Class Method Details

.capabilities ⇒ Object 



23
 
# File 'lib/legion/extensions/llm/ollama/provider.rb', line 23

def capabilities = Capabilities

.configuration_requirements ⇒ Object 



22
 
# File 'lib/legion/extensions/llm/ollama/provider.rb', line 22

def configuration_requirements = []

.default_tier ⇒ Object 



21
 
# File 'lib/legion/extensions/llm/ollama/provider.rb', line 21

def default_tier = :local

.default_transport ⇒ Object 



20
 
# File 'lib/legion/extensions/llm/ollama/provider.rb', line 20

def default_transport = :http

.local? ⇒ Boolean

Returns:

  • (Boolean) 


19
 
# File 'lib/legion/extensions/llm/ollama/provider.rb', line 19

def local? = true

.slug ⇒ Object 



18
 
# File 'lib/legion/extensions/llm/ollama/provider.rb', line 18

def slug = 'ollama'

Instance Method Details

#api_base ⇒ Object 



52
53
54
 
# File 'lib/legion/extensions/llm/ollama/provider.rb', line 52

def api_base
  resolve_base_url || normalize_url(settings[:instances][:default][:endpoint])
end

#completion_url ⇒ Object 



60
 
# File 'lib/legion/extensions/llm/ollama/provider.rb', line 60

def completion_url = '/api/chat'

#config_base_url ⇒ Object 



56
57
58
 
# File 'lib/legion/extensions/llm/ollama/provider.rb', line 56

def config_base_url
  config.respond_to?(:base_url) ? config.base_url : settings[:base_url]
end

#discover_offerings(live: false, raise_on_unreachable: false, **filters) ⇒ Object 



89
90
91
92
93
94
95
96
97
98
99
100
101
 
# File 'lib/legion/extensions/llm/ollama/provider.rb', line 89

def discover_offerings(live: false, raise_on_unreachable: false, **filters)
  return filter_cached_offerings(Array(@cached_offerings), filters) unless live

  provider_health = health(live:)
  @cached_offerings = discover_live_offerings(filters, provider_health, live:)
  log_discover_complete(@cached_offerings)
  @cached_offerings
rescue Faraday::ConnectionFailed, Faraday::TimeoutError => e
  log.warn("[#{slug}] instance=#{provider_instance_id} unreachable: #{e.message}")
  raise if raise_on_unreachable

  []
end

#embedding_url ⇒ Object 



65
 
# File 'lib/legion/extensions/llm/ollama/provider.rb', line 65

def embedding_url(**) = '/api/embed'

#fetch_model_detail(model_name) ⇒ Object 



111
112
113
114
115
116
117
118
119
 
# File 'lib/legion/extensions/llm/ollama/provider.rb', line 111

def fetch_model_detail(model_name)
  raw = show_model(model_name)
  context_window = extract_context_window(raw)
  { context_window: context_window, capabilities: extract_capabilities(raw) }.compact
rescue StandardError => e
  handle_exception(e, level: :warn, handled: true, operation: 'ollama.fetch_model_detail',
                      model: model_name)
  nil
end

#list_models(live: false, **filters) ⇒ Object 



82
83
84
85
86
87
 
# File 'lib/legion/extensions/llm/ollama/provider.rb', line 82

def list_models(live: false, **filters)
  log.debug { "ollama provider discovering models endpoint=#{api_base}#{models_url}" }
  super.tap do |models|
    log.debug { "ollama provider discovered model_count=#{models.size}" }
  end
end

#list_running_models ⇒ Object 



69
70
71
72
73
74
75
 
# File 'lib/legion/extensions/llm/ollama/provider.rb', line 69

def list_running_models
  log.debug { "ollama provider listing running models endpoint=#{api_base}#{running_models_url}" }
  connection.get(running_models_url).body.fetch('models', [])
rescue StandardError => e
  handle_exception(e, level: :error, handled: true, operation: 'ollama.list_running_models')
  []
end

#models_url ⇒ Object 



62
 
# File 'lib/legion/extensions/llm/ollama/provider.rb', line 62

def models_url = '/api/tags'

#pull_model(model, stream: false) ⇒ Object 



121
122
123
124
125
126
127
128
 
# File 'lib/legion/extensions/llm/ollama/provider.rb', line 121

def pull_model(model, stream: false)
  log.debug { "ollama provider pulling model=#{model} stream=#{stream}" }
  log.info { "pulling model #{model} stream=#{stream}" }
  connection.post(pull_url, { model: model, stream: stream }).body
rescue StandardError => e
  handle_exception(e, level: :error, handled: true, operation: 'ollama.pull_model')
  raise
end

#pull_url ⇒ Object 



66
 
# File 'lib/legion/extensions/llm/ollama/provider.rb', line 66

def pull_url = '/api/pull'

#readiness(live: false) ⇒ Object 



77
78
79
80
 
# File 'lib/legion/extensions/llm/ollama/provider.rb', line 77

def readiness(live: false)
  log.debug { "ollama provider checking readiness live=#{live} endpoint=#{api_base}" }
  super
end

#running_models_url ⇒ Object 



63
 
# File 'lib/legion/extensions/llm/ollama/provider.rb', line 63

def running_models_url = '/api/ps'

#settings ⇒ Object 



44
45
46
 
# File 'lib/legion/extensions/llm/ollama/provider.rb', line 44

def settings
  Ollama.default_settings
end

#show_model(model) ⇒ Object 



103
104
105
106
107
108
109
 
# File 'lib/legion/extensions/llm/ollama/provider.rb', line 103

def show_model(model)
  log.debug { "ollama provider fetching model details model=#{model}" }
  connection.post(show_model_url, { model: model }).body
rescue StandardError => e
  handle_exception(e, level: :error, handled: true, operation: 'ollama.show_model')
  raise
end

#show_model_url ⇒ Object 



64
 
# File 'lib/legion/extensions/llm/ollama/provider.rb', line 64

def show_model_url = '/api/show'

#stream_url ⇒ Object 



61
 
# File 'lib/legion/extensions/llm/ollama/provider.rb', line 61

def stream_url = '/api/chat'

#translator ⇒ Object 



48
49
50
 
# File 'lib/legion/extensions/llm/ollama/provider.rb', line 48

def translator
  @translator ||= Translator.new(config: config)
end

#version_url ⇒ Object 



67
 
# File 'lib/legion/extensions/llm/ollama/provider.rb', line 67

def version_url = '/api/version'