ollama-ruby 0.4.0 → 0.5.0

data/bin/ollama_cli

@@ -16,6 +16,8 @@ def usage
       -M OPTIONS     the ollama model options to use, OLLAMA_MODEL_OPTIONS
       -s SYSTEM      the system prompt to use as a file, OLLAMA_SYSTEM
       -p PROMPT      the user prompt to use as a file, OLLAMA_PROMPT
+                     if it contains %{stdin} it is substituted by stdin input
+      -P VARIABLE    sets prompt var %{foo} to "bar" if VARIABLE is foo=bar
       -H HANDLER     the handler to use for the response, defaults to Print
       -S             use streaming for generation
       -h             this help
@@ -24,7 +26,7 @@ def usage
   exit 0
 end
 
-opts = go 'u:m:M:s:p:H:Sh', defaults: { ?H => 'Print', ?M => '{}' }
+opts = go 'u:m:M:s:p:P:H:Sh', defaults: { ?H => 'Print', ?M => '{}' }
 
 opts[?h] and usage
 
@@ -38,14 +40,14 @@ prompt   = get_file_argument(opts[?p], default: ENV['OLLAMA_PROMPT'])
 
 if prompt.nil?
   prompt = STDIN.read
-elsif c = prompt.scan('%s').size
-  case c
-  when 0
-  when 1
-    prompt = prompt % STDIN.read
-  else
-    STDERR.puts "Found more than one plaeceholder %s. => Ignoring."
-  end
+else
+  vars = prompt.scan(/%\{([^}]+)\}/).inject([], &:concat).uniq.map(&:to_sym)
+  stdin = (STDIN.read if vars.include?(:stdin)).to_s
+  values = opts[?P].to_a.inject({ stdin: }) { |h, pair|
+    n, v = pair.split(?=, 2)
+    h.merge(n.to_sym => v)
+  }
+  prompt = prompt % values
 end
 
 if ENV['DEBUG'].to_i == 1

data/lib/ollama/documents/cache/redis_backed_memory_cache.rb

@@ -2,16 +2,18 @@ require 'redis'
 
 class Ollama::Documents
   class RedisBackedMemoryCache < MemoryCache
-    def initialize(prefix:, url: ENV['REDIS_URL'])
+    def initialize(prefix:, url: ENV['REDIS_URL'], object_class: nil)
       super(prefix:)
       url or raise ArgumentError, 'require redis url'
-      @prefix, @url = prefix, url
-      @redis_cache  = Ollama::Documents::RedisCache.new(prefix:, url:)
+      @prefix, @url, @object_class = prefix, url, object_class
+      @redis_cache  = Ollama::Documents::RedisCache.new(prefix:, url:, object_class:)
       @redis_cache.full_each do |key, value|
         @data[key] = value
       end
     end
 
+    attr_reader :object_class
+
     def redis
       @redis_cache.redis
     end
@@ -32,13 +34,5 @@ class Ollama::Documents
       super
       self
     end
-
-    def pre(key)
-      [ @prefix, key ].join
-    end
-
-    def unpre(key)
-      key.sub(/\A#@prefix/, '')
-    end
   end
 end

data/lib/ollama/documents/cache/redis_cache.rb

@@ -4,11 +4,13 @@ require 'redis'
 class Ollama::Documents::RedisCache
   include Ollama::Documents::Cache::Common
 
-  def initialize(prefix:, url: ENV['REDIS_URL'])
+  def initialize(prefix:, url: ENV['REDIS_URL'], object_class: nil, ex: nil)
     url or raise ArgumentError, 'require redis url'
-    @prefix, @url = prefix, url
+    @prefix, @url, @object_class, @ex = prefix, url, object_class, ex
   end
 
+  attr_reader :object_class
+
   def redis
     @redis ||= Redis.new(url: @url)
   end
@@ -16,12 +18,16 @@ class Ollama::Documents::RedisCache
   def [](key)
     value = redis.get(pre(key))
     unless value.nil?
-      JSON(value, object_class: Ollama::Documents::Record)
+      JSON(value, object_class:)
     end
   end
 
   def []=(key, value)
-    redis.set(pre(key), JSON(value))
+    redis.set(pre(key), JSON.generate(value), ex: @ex)
+  end
+
+  def ttl(key)
+    redis.ttl(pre(key))
   end
 
   def key?(key)
@@ -50,7 +56,7 @@ class Ollama::Documents::RedisCache
   include Enumerable
 
   def full_each(&block)
-    redis.scan_each do |key|
+    redis.scan_each(match: [ Ollama::Documents, ?* ] * ?-) do |key|
       value = redis.get(key) or next
       value = JSON(value, object_class: Ollama::Documents::Record)
       block.(key, value)

data/lib/ollama/documents/splitters/character.rb

@@ -2,8 +2,9 @@ module Ollama::Documents::Splitters
   class Character
     DEFAULT_SEPARATOR = /(?:\r?\n){2,}/
 
-    def initialize(separator: DEFAULT_SEPARATOR, include_separator: false, chunk_size: 4096)
-      @separator, @include_separator, @chunk_size = separator, include_separator, chunk_size
+    def initialize(separator: DEFAULT_SEPARATOR, include_separator: false, combining_string: "\n\n", chunk_size: 4096)
+      @separator, @include_separator, @combining_string, @chunk_size =
+        separator, include_separator, combining_string, chunk_size
       if include_separator
         @separator = Regexp.new("(#@separator)")
       end
@@ -22,7 +23,7 @@ module Ollama::Documents::Splitters
       current_text = +''
       texts.each do |t|
         if current_text.size + t.size < @chunk_size
-          current_text += t
+          current_text << t << @combining_string
         else
           current_text.empty? or result << current_text
           current_text = t
@@ -41,11 +42,11 @@ module Ollama::Documents::Splitters
       //,
     ].freeze
 
-    def initialize(separators: DEFAULT_SEPARATORS, include_separator: false, chunk_size: 4096)
+    def initialize(separators: DEFAULT_SEPARATORS, include_separator: false, combining_string: "\n\n", chunk_size: 4096)
       separators.empty? and
         raise ArgumentError, "non-empty array of separators required"
-      @separators, @include_separator, @chunk_size =
-        separators, include_separator, chunk_size
+      @separators, @include_separator, @combining_string, @chunk_size =
+        separators, include_separator, combining_string, chunk_size
     end
 
     def split(text, separators: @separators)
@@ -55,6 +56,7 @@ module Ollama::Documents::Splitters
       texts = Character.new(
         separator:,
         include_separator: @include_separator,
+        combining_string: @combining_string,
         chunk_size: @chunk_size
       ).split(text)
       texts.count == 0 and return [ text ]

data/lib/ollama/documents/splitters/semantic.rb

@@ -12,7 +12,7 @@ module Ollama::Documents::Splitters
     def split(text, batch_size: 100, breakpoint: :percentile, **opts)
       sentences  = Ollama::Documents::Splitters::Character.new(
         separator: @separator,
-        include_separator: true,
+        include_separator: opts.fetch(:include_separator, true),
         chunk_size: 1,
       ).split(text)
       embeddings = sentences.with_infobar(label: 'Split').each_slice(batch_size).inject([]) do |e, batch|

data/lib/ollama/documents.rb

@@ -35,16 +35,19 @@ class Ollama::Documents
     alias inspect to_s
   end
 
-  def initialize(ollama:, model:, model_options: nil, collection: default_collection, cache: MemoryCache, redis_url: nil)
-    @ollama, @model, @model_options, @collection = ollama, model, model_options, collection.to_sym
-    @cache, @redis_url = connect_cache(cache), redis_url
+  def initialize(ollama:, model:, model_options: nil, collection: nil, cache: MemoryCache, redis_url: nil)
+    collection ||= default_collection
+    @ollama, @model, @model_options, @collection =
+      ollama, model, model_options, collection.to_sym
+    @redis_url = redis_url
+    @cache = connect_cache(cache)
   end
 
   def default_collection
     :default
   end
 
-  attr_reader :ollama, :model, :collection
+  attr_reader :ollama, :model, :collection, :cache
 
   def collection=(new_collection)
     @collection   = new_collection.to_sym
@@ -161,7 +164,7 @@ class Ollama::Documents
     cache = nil
     if cache_class.instance_method(:redis)
       begin
-        cache = cache_class.new(prefix:)
+        cache = cache_class.new(prefix:, url: @redis_url, object_class: Record)
         cache.size
       rescue Redis::CannotConnectError
         STDERR.puts(

data/lib/ollama/utils/fetcher.rb

@@ -7,32 +7,43 @@ require 'stringio'
 class Ollama::Utils::Fetcher
   module ContentType
     attr_accessor :content_type
+
+    def self.failed
+      object = StringIO.new.extend(self)
+      object.content_type = MIME::Types['text/plain'].first
+      object
+    end
   end
 
   class RetryWithoutStreaming < StandardError; end
 
-  def initialize(debug: false)
-    @debug     = debug
-    @started   = false
-    @streaming = true
+  def initialize(debug: false, http_options: {})
+    @debug        = debug
+    @started      = false
+    @streaming    = true
+    @http_options = http_options
   end
 
   def self.get(url, **options, &block)
     new(**options).get(url, &block)
   end
 
+  def excon(url, **options)
+    Excon.new(url, options.merge(@http_options))
+  end
+
   def get(url, &block)
     response = nil
     Tempfile.open do |tmp|
       infobar.label = 'Getting'
       if @streaming
-        response = Excon.get(url, headers:, response_block: callback(tmp))
+        response = excon(url, headers:, response_block: callback(tmp)).request(method: :get)
         response.status != 200 || !@started and raise RetryWithoutStreaming
         decorate_io(tmp, response)
         infobar.finish
         block.(tmp)
       else
-        response = Excon.get(url, headers:, middlewares:)
+        response = excon(url, headers:, middlewares:).request(method: :get)
         if response.status != 200
           raise "invalid response status code"
         end
@@ -52,7 +63,7 @@ class Ollama::Utils::Fetcher
     if @debug && !e.is_a?(RuntimeError)
       STDERR.puts "#{e.backtrace * ?\n}"
     end
-    yield StringIO.new.extend(ContentType)
+    yield ContentType.failed
   end
 
   def headers
@@ -104,4 +115,24 @@ class Ollama::Utils::Fetcher
       end
     end
   end
+
+  def self.execute(command, &block)
+    Tempfile.open do |tmp|
+      IO.popen(command) do |command|
+        until command.eof?
+          tmp.write command.read(4096)
+        end
+        tmp.rewind
+        tmp.extend(Ollama::Utils::Fetcher::ContentType)
+        tmp.content_type = MIME::Types['text/plain'].first
+        block.(tmp)
+      end
+    end
+  rescue => e
+    STDERR.puts "Cannot execute #{command.inspect} (#{e})"
+    if @debug && !e.is_a?(RuntimeError)
+      STDERR.puts "#{e.backtrace * ?\n}"
+    end
+    yield ContentType.failed
+  end
 end

data/lib/ollama/utils/file_argument.rb

@@ -23,12 +23,10 @@ module Ollama::Utils::FileArgument
     if path_or_content.present? && path_or_content.size < 2 ** 15 &&
         File.basename(path_or_content).size < 2 ** 8 &&
         File.exist?(path_or_content)
-      then
+    then
       File.read(path_or_content)
-    elsif path_or_content.present?
-      path_or_content
     else
-      default
+      path_or_content.full? || default
     end
   end
 end

data/lib/ollama/version.rb

@@ -1,6 +1,6 @@
 module Ollama
   # Ollama version
-  VERSION         = '0.4.0'
+  VERSION         = '0.5.0'
   VERSION_ARRAY   = VERSION.split('.').map(&:to_i) # :nodoc:
   VERSION_MAJOR   = VERSION_ARRAY[0] # :nodoc:
   VERSION_MINOR   = VERSION_ARRAY[1] # :nodoc:

data/lib/ollama.rb

@@ -1,4 +1,5 @@
 require 'json'
+require 'logger'
 require 'excon'
 
 module Ollama

data/ollama-ruby.gemspec

@@ -1,14 +1,14 @@
 # -*- encoding: utf-8 -*-
-# stub: ollama-ruby 0.4.0 ruby lib
+# stub: ollama-ruby 0.5.0 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "ollama-ruby".freeze
-  s.version = "0.4.0".freeze
+  s.version = "0.5.0".freeze
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib".freeze]
   s.authors = ["Florian Frank".freeze]
-  s.date = "2024-09-21"
+  s.date = "2024-09-26"
   s.description = "Library that allows interacting with the Ollama API".freeze
   s.email = "flori@ping.de".freeze
   s.executables = ["ollama_console".freeze, "ollama_chat".freeze, "ollama_update".freeze, "ollama_cli".freeze]
@@ -24,7 +24,7 @@ Gem::Specification.new do |s|
 
   s.specification_version = 4
 
-  s.add_development_dependency(%q<gem_hadar>.freeze, ["~> 1.17.1".freeze])
+  s.add_development_dependency(%q<gem_hadar>.freeze, ["~> 1.18.0".freeze])
   s.add_development_dependency(%q<all_images>.freeze, ["~> 0.4".freeze])
   s.add_development_dependency(%q<rspec>.freeze, ["~> 3.2".freeze])
   s.add_development_dependency(%q<webmock>.freeze, [">= 0".freeze])
@@ -45,4 +45,6 @@ Gem::Specification.new do |s|
   s.add_runtime_dependency(%q<search_ui>.freeze, ["~> 0.0".freeze])
   s.add_runtime_dependency(%q<amatch>.freeze, ["~> 0.4.1".freeze])
   s.add_runtime_dependency(%q<pdf-reader>.freeze, ["~> 2.0".freeze])
+  s.add_runtime_dependency(%q<logger>.freeze, ["~> 1.0".freeze])
+  s.add_runtime_dependency(%q<json>.freeze, ["~> 2.0".freeze])
 end

data/spec/ollama/documents/redis_backed_memory_cache_spec.rb

@@ -35,6 +35,17 @@ RSpec.describe Ollama::Documents::RedisBackedMemoryCache do
       expect(cache).to be_a described_class
     end
 
+    it 'defaults to nil object_class' do
+      cache = described_class.new prefix: 'test-', url: 'something'
+      expect(cache.object_class).to be_nil
+    end
+
+    it 'can be configured with object_class' do
+      object_class = Class.new(JSON::GenericObject)
+      cache = described_class.new(prefix: 'test-', url: 'something', object_class:)
+      expect(cache.object_class).to eq object_class
+    end
+
     it 'has Redis client' do
       expect(cache.redis).to eq redis
     end

data/spec/ollama/documents/redis_cache_spec.rb

@@ -6,6 +6,17 @@ RSpec.describe Ollama::Documents::RedisCache do
     expect(cache).to be_a described_class
   end
 
+  it 'defaults to nil object_class' do
+    cache = described_class.new prefix: 'test-', url: 'something'
+    expect(cache.object_class).to be_nil
+  end
+
+  it 'can be configured with object_class' do
+    object_class = Class.new(JSON::GenericObject)
+    cache = described_class.new(prefix: 'test-', url: 'something', object_class:)
+    expect(cache.object_class).to eq object_class
+  end
+
   it 'raises ArgumentError if url is missing' do
     expect {
       described_class.new prefix: 'test-', url: nil
@@ -37,8 +48,17 @@ RSpec.describe Ollama::Documents::RedisCache do
 
     it 'can set a value for a key' do
       key, value = 'foo', { test: true }
-      expect(redis).to receive(:set).with('test-' + key, JSON(value))
+      expect(redis).to receive(:set).with('test-' + key, JSON(value), ex: nil)
+      cache[key] = value
+    end
+
+    it 'can set a value for a key with ttl' do
+      cache = described_class.new prefix: 'test-', url: 'something', ex: 3_600
+      key, value = 'foo', { test: true }
+      expect(redis).to receive(:set).with('test-' + key, JSON(value), ex: 3_600)
       cache[key] = value
+      allow(redis).to receive(:ttl).with('test-' + key).and_return 3_600
+      expect(cache.ttl(key)).to eq 3_600
     end
 
     it 'can determine if key exists' do

data/spec/ollama/documents/splitters/character_spec.rb

@@ -2,7 +2,7 @@ require 'spec_helper'
 
 RSpec.describe Ollama::Documents::Splitters::Character do
   let :splitter do
-    described_class.new chunk_size: 23
+    described_class.new chunk_size: 23, combining_string: ''
   end
 
   it 'can be instantiated' do
@@ -10,29 +10,41 @@ RSpec.describe Ollama::Documents::Splitters::Character do
   end
 
   it 'can split' do
-    text = [ "A" * 10 ] * 10 * "\n\n"
+    text = [ ?A * 10 ] * 10 * "\n\n"
     result = splitter.split(text)
     expect(result.count).to eq 5
     expect(result.to_a.join('')).to eq ?A * 100
   end
 
+  it 'can split combining with separation' do
+    splitter = described_class.new chunk_size: 25, include_separator: false,
+      combining_string: ?X
+    text = [ ?A * 10 ] * 10 * "\n\n"
+    result = splitter.split(text)
+    expect(result.count).to eq 5
+    expect(result.to_a.join(?B)).to eq\
+      "AAAAAAAAAAXAAAAAAAAAAXBAAAAAAAAAAAAAAAAAAAAXBAAAAAAAAAAAAAAAAAAAAXB"\
+      "AAAAAAAAAAAAAAAAAAAAXBAAAAAAAAAAAAAAAAAAAAX"
+  end
+
   it 'can split including separator' do
-    splitter = described_class.new chunk_size: 25, include_separator: true
-    text = [ "A" * 10 ] * 10 * "\n\n"
+    splitter = described_class.new chunk_size: 25, include_separator: true,
+      combining_string: ''
+    text = [ ?A * 10 ] * 10 * "\n\n"
     result = splitter.split(text)
     expect(result.count).to eq 5
     expect(result.to_a.join('')).to eq text
   end
 
   it 'cannot split' do
-    text = [ "A" * 10 ] * 10 * "\n"
+    text = [ ?A * 10 ] * 10 * "\n"
     result = splitter.split(text)
     expect(result.count).to eq 1
     expect(result.to_a.join('').count(?A)).to eq text.count(?A)
   end
 
   it 'cannot split2' do
-    text = "A" * 25
+    text = ?A * 25
     result = splitter.split(text)
     expect(result.count).to eq 1
     expect(result.to_a.join('')).to eq ?A * 25
@@ -48,7 +60,7 @@ end
 
 RSpec.describe Ollama::Documents::Splitters::RecursiveCharacter do
   let :splitter do
-    described_class.new chunk_size: 23
+    described_class.new chunk_size: 23, combining_string: ''
   end
 
   it 'can be instantiated' do
@@ -56,7 +68,7 @@ RSpec.describe Ollama::Documents::Splitters::RecursiveCharacter do
   end
 
   it 'can split' do
-    text = [ "A" * 10 ] * 10 * "\n\n"
+    text = [ ?A * 10 ] * 10 * "\n\n"
     result = splitter.split(text)
     expect(result.count).to eq 5
     expect(result.to_a.join('')).to eq ?A * 100
@@ -65,30 +77,32 @@ RSpec.describe Ollama::Documents::Splitters::RecursiveCharacter do
   it 'cannot split' do
     splitter = described_class.new chunk_size: 23, include_separator: true,
       separators: described_class::DEFAULT_SEPARATORS[0..-2]
-    text = "A" * 25
+    text = ?A * 25
     result = splitter.split(text)
     expect(result.count).to eq 1
     expect(result.to_a.join('')).to eq ?A * 25
   end
 
   it 'can split including separator' do
-    splitter = described_class.new chunk_size: 25, include_separator: true
-    text = [ "A" * 10 ] * 10 * "\n\n"
+    splitter = described_class.new chunk_size: 25, include_separator: true,
+      combining_string: ''
+    text = [ ?A * 10 ] * 10 * "\n\n"
     result = splitter.split(text)
     expect(result.count).to eq 5
     expect(result.to_a.join('')).to eq text
   end
 
   it 'can split single newline as well' do
-    text = [ "A" * 10 ] * 10 * "\n"
+    text = [ ?A * 10 ] * 10 * "\n"
     result = splitter.split(text)
     expect(result.count).to eq 5
     expect(result.to_a.join('')).to eq ?A * 100
   end
 
   it 'can split single newline as well including separator' do
-    splitter = described_class.new chunk_size: 25, include_separator: true
-    text = [ "A" * 10 ] * 10 * "\n"
+    splitter = described_class.new chunk_size: 25, include_separator: true,
+      combining_string: ''
+    text = [ ?A * 10 ] * 10 * "\n"
     result = splitter.split(text)
     expect(result.count).to eq 5
     expect(result.to_a.join('')).to eq text

data/spec/ollama/utils/fetcher_spec.rb

@@ -33,6 +33,28 @@ RSpec.describe Ollama::Utils::Fetcher do
     end
   end
 
+  it 'can #get without ssl peer verification' do
+    fetcher = described_class.new(
+      http_options: { ssl_verify_peer: false }
+    )
+    stub_request(:get, 'https://www.example.com/hello').
+      with(headers: fetcher.headers).
+      to_return(
+        status: 200,
+        body: 'world',
+        headers: { 'Content-Type' => 'text/plain' },
+      )
+    expect(Excon).to receive(:new).with(
+      'https://www.example.com/hello',
+      hash_including(ssl_verify_peer: false)
+    ).and_call_original
+    fetcher.get(url) do |tmp|
+      expect(tmp).to be_a Tempfile
+      expect(tmp.read).to eq 'world'
+      expect(tmp.content_type).to eq 'text/plain'
+    end
+  end
+
   it 'can #get and fallback from streaming' do
     stub_request(:get, 'https://www.example.com/hello').
       with(headers: fetcher.headers).
@@ -58,6 +80,7 @@ RSpec.describe Ollama::Utils::Fetcher do
     fetcher.get(url) do |tmp|
       expect(tmp).to be_a StringIO
       expect(tmp.read).to eq ''
+      expect(tmp.content_type).to eq 'text/plain'
     end
   end
 
@@ -72,4 +95,21 @@ RSpec.describe Ollama::Utils::Fetcher do
       expect(file.content_type).to eq 'application/x-ruby'
     end
   end
+
+  it 'can .execute' do
+    described_class.execute('echo -n hello world') do |file|
+      expect(file).to be_a Tempfile
+      expect(file.read).to eq 'hello world'
+      expect(file.content_type).to eq 'text/plain'
+    end
+  end
+
+  it 'can .execute and fail' do
+    allow(IO).to receive(:popen).and_raise StandardError
+    described_class.execute('foobar') do |file|
+      expect(file).to be_a StringIO
+      expect(file.read).to be_empty
+      expect(file.content_type).to eq 'text/plain'
+    end
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ollama-ruby
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Florian Frank
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-09-21 00:00:00.000000000 Z
+date: 2024-09-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gem_hadar
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.17.1
+        version: 1.18.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.17.1
+        version: 1.18.0
 - !ruby/object:Gem::Dependency
   name: all_images
   requirement: !ruby/object:Gem::Requirement
@@ -304,6 +304,34 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: logger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
 description: Library that allows interacting with the Ollama API
 email: flori@ping.de
 executables: