ruby-spacy 0.4.1 → 0.6.0

data/lib/ruby-spacy.rb

@@ -1,11 +1,12 @@
 # frozen_string_literal: true
 
 require_relative "ruby-spacy/version"
+require_relative "ruby-spacy/llm_client_base"
 require_relative "ruby-spacy/openai_client"
+require_relative "ruby-spacy/anthropic_client"
 require_relative "ruby-spacy/openai_helper"
-require "numpy"
+require_relative "ruby-spacy/anthropic_helper"
 require "pycall"
-require "timeout"
 require "json"
 require "base64"
 
@@ -24,6 +25,16 @@ module Spacy
   end
 
   Builtins = PyCall.import_module("builtins")
+
+  # Python `spacy` module
+  PySpacy = spacy
+
+  # Python `__main__` module (used for the deprecated `Language#spacy_nlp_id`)
+  PyMain = PyCall.import_module("__main__")
+
+  # Python `base64` module (used for `Doc.from_bytes`)
+  PyBase64 = PyCall.import_module("base64")
+
   SpacyVersion = spacy.__version__
 
   # Python `Language` class
@@ -47,6 +58,92 @@ module Spacy
   # Python `displacy` object
   PyDisplacy = PyCall.import_module('spacy.displacy')
 
+  # Python-side helpers, kept in a dedicated module so that nothing is added to
+  # the user's `__main__` namespace. They exist because spaCy's vocabulary keys,
+  # matcher ids, and integer attributes (e.g. `Token#orth`) are unsigned 64-bit
+  # integers that do not survive the PyCall boundary in either direction: on the
+  # Python -> Ruby side, values from 2**62 up to 2**63-1 are silently corrupted
+  # into negative numbers and values from 2**63 up come back as nil; on the
+  # Ruby -> Python side, passing a large Ruby Integer raises TypeError
+  # ("an integer is required"). Moving ids as decimal strings and resolving them
+  # in Python sidesteps both directions.
+  #
+  # - key_texts(nlp, keys): used by `Language#most_similar`;
+  #   returns [[key_string, text], ...]
+  # - string_lookup(nlp, key_str): used by `Language#vocab_string_lookup`;
+  #   returns the string for the given id
+  # - matcher_matches(matcher, doc): used by `Matcher#match`;
+  #   returns [(match_id_string, start, end, label_string), ...]
+  # - attr_or_call(obj, name, args): used by `Spacy.safe_py_send`; returns the
+  #   attribute (called with args if given), with Python ints stringified with
+  #   INT_PREFIX so they survive the PyCall boundary
+  # - load_with_timeout(model, seconds): used by `Language#initialize`; loads a
+  #   model on a Python thread and returns nil if it does not finish in time
+  #   (Ruby's Timeout cannot fire while PyCall holds the GVL)
+  PyHelpers = PyCall.import_module("types").ModuleType.new("ruby_spacy_helpers")
+  PyCall.exec(<<~PYTHON, globals: PyHelpers.__dict__)
+    import threading
+
+    _PREFIX = "__ruby_spacy_int__:"
+
+    def key_texts(nlp, keys):
+        return [[str(key), nlp.vocab[key].text] for key in keys]
+
+    def string_lookup(nlp, key_str):
+        return nlp.vocab.strings[int(key_str)]
+
+    def matcher_matches(matcher, doc):
+        return [(str(m[0]), m[1], m[2], matcher.vocab.strings[m[0]]) for m in matcher(doc)]
+
+    def attr_or_call(obj, name, args):
+        v = getattr(obj, name)
+        if args:
+            v = v(*args)
+        if type(v) is int:
+            return _PREFIX + str(v)
+        return v
+
+    def load_with_timeout(model, seconds):
+        import spacy
+        box = {}
+        def run():
+            try:
+                box["nlp"] = spacy.load(model)
+            except BaseException as e:
+                box["err"] = e
+        t = threading.Thread(target=run, daemon=True)
+        t.start()
+        t.join(seconds)
+        if t.is_alive():
+            return None
+        if "err" in box:
+            raise box["err"]
+        return box["nlp"]
+  PYTHON
+
+  # Marks integer values that `PyHelpers.attr_or_call` stringified so they can
+  # survive the PyCall boundary (see the comment above `PyHelpers`)
+  INT_PREFIX = "__ruby_spacy_int__:"
+
+  # Calls an attribute or method on a Python object. spaCy exposes several
+  # unsigned 64-bit integer attributes (e.g. `Token#orth`) that are silently
+  # corrupted when they cross the PyCall boundary (see the comment above
+  # `PyHelpers`), so when the result looks corrupted (nil, or a negative
+  # Integer, which cannot occur legitimately for these ids) the value is
+  # fetched again via `PyHelpers.attr_or_call`, which stringifies ints on the
+  # Python side. Ordinary values (strings, booleans, floats, Python objects,
+  # small non-negative integers) are returned as-is.
+  def self.safe_py_send(py_obj, name, args)
+    v = py_obj.send(name, *args)
+    return v unless v.nil? || (v.is_a?(Integer) && v.negative?)
+
+    r = PyHelpers.attr_or_call(py_obj, name.to_s, args)
+    r.is_a?(String) && r.start_with?(INT_PREFIX) ? r.delete_prefix(INT_PREFIX).to_i : r
+  end
+
+  # Python `numpy` module (always present as a spaCy dependency)
+  PyNp = PyCall.import_module("numpy")
+
   # A utility module method to convert Python's generator object to a Ruby array,
   # mainly used on the items inside the array returned from dependency-related methods
   # such as {Span#rights}, {Span#lefts} and {Span#subtree}.
@@ -234,7 +331,7 @@ module Spacy
     #   doc = Spacy::Doc.from_bytes(nlp, bytes)
     def self.from_bytes(nlp, byte_string)
       b64 = Base64.strict_encode64(byte_string)
-      py_bytes = PyCall.eval("__import__('base64').b64decode('#{b64}')")
+      py_bytes = PyBase64.b64decode(b64)
       py_doc = nlp.py_nlp.call("").from_bytes(py_bytes)
       new(nlp.py_nlp, py_doc: py_doc)
     end
@@ -310,7 +407,8 @@ module Spacy
     # @param access_token [String, nil] OpenAI API key (defaults to OPENAI_API_KEY env var)
     # @param max_completion_tokens [Integer] Maximum tokens in the response
     # @param max_tokens [Integer] Alias for max_completion_tokens (deprecated, for backward compatibility)
-    # @param temperature [Float] Sampling temperature (ignored for GPT-5 models)
+    # @param temperature [Float, nil] Sampling temperature (omitted from requests
+    #   when nil; models that reject it are retried without it)
     # @param model [String] The model to use (default: gpt-5-mini)
     # @param messages [Array<Hash>] Conversation history (for recursive tool calls). Note: this array is modified in place when tool calls occur.
     # @param prompt [String, nil] System prompt for the query
@@ -318,8 +416,8 @@ module Spacy
     def openai_query(access_token: nil,
                      max_completion_tokens: nil,
                      max_tokens: nil,
-                     temperature: 0.7,
-                     model: "gpt-5-mini",
+                     temperature: nil,
+                     model: OpenAIClient::DEFAULT_MODEL,
                      messages: [],
                      prompt: nil,
                      response_format: nil,
@@ -420,7 +518,7 @@ module Spacy
         message["content"]
       end
     rescue OpenAIClient::APIError => e
-      puts "Error: OpenAI API call failed - #{e.message}"
+      warn "Error: OpenAI API call failed - #{e.message}"
       nil
     end
 
@@ -429,10 +527,11 @@ module Spacy
     # @param access_token [String, nil] OpenAI API key (defaults to OPENAI_API_KEY env var)
     # @param max_completion_tokens [Integer] Maximum tokens in the response
     # @param max_tokens [Integer] Alias for max_completion_tokens (deprecated, for backward compatibility)
-    # @param temperature [Float] Sampling temperature (ignored for GPT-5 models)
+    # @param temperature [Float, nil] Sampling temperature (omitted from requests
+    #   when nil; models that reject it are retried without it)
     # @param model [String] The model to use (default: gpt-5-mini)
     # @return [String, nil] The completed text
-    def openai_completion(access_token: nil, max_completion_tokens: nil, max_tokens: nil, temperature: 0.7, model: "gpt-5-mini")
+    def openai_completion(access_token: nil, max_completion_tokens: nil, max_tokens: nil, temperature: nil, model: OpenAIClient::DEFAULT_MODEL)
       # Support both max_completion_tokens and max_tokens for backward compatibility
       max_completion_tokens ||= max_tokens || 1000
 
@@ -450,7 +549,7 @@ module Spacy
       )
       response.dig("choices", 0, "message", "content")
     rescue OpenAIClient::APIError => e
-      puts "Error: OpenAI API call failed - #{e.message}"
+      warn "Error: OpenAI API call failed - #{e.message}"
       nil
     end
 
@@ -460,12 +559,12 @@ module Spacy
     # @param model [String] The embeddings model (default: text-embedding-3-small)
     # @param dimensions [Integer, nil] The number of dimensions for the output embeddings (nil uses model default)
     # @return [Array<Float>, nil] The embedding vector
-    def openai_embeddings(access_token: nil, model: "text-embedding-3-small", dimensions: nil)
+    def openai_embeddings(access_token: nil, model: OpenAIClient::DEFAULT_EMBEDDINGS_MODEL, dimensions: nil)
       client = openai_client(access_token)
       response = client.embeddings(model: model, input: @text, dimensions: dimensions)
       response.dig("data", 0, "embedding")
     rescue OpenAIClient::APIError => e
-      puts "Error: OpenAI API call failed - #{e.message}"
+      warn "Error: OpenAI API call failed - #{e.message}"
       nil
     end
 
@@ -483,7 +582,7 @@ module Spacy
 
     # Methods defined in Python but not wrapped in ruby-spacy can be called by this dynamic method handling mechanism.
     def method_missing(name, *args)
-      @py_doc.send(name, *args)
+      Spacy.safe_py_send(@py_doc, name, args)
     end
 
     def respond_to_missing?(sym, include_private = false)
@@ -497,28 +596,40 @@ module Spacy
 
   # See also spaCy Python API document for [`Language`](https://spacy.io/api/language).
   class Language
-    # @return [String] an identifier string that can be used to refer to the Python `Language` object inside `PyCall::exec` or `PyCall::eval`
-    attr_reader :spacy_nlp_id
-
     # @return [Object] a Python `Language` instance accessible via `PyCall`
     attr_reader :py_nlp
 
+    # @return [String] an identifier string that can be used to refer to the Python `Language` object inside `PyCall::exec` or `PyCall::eval`
+    # @deprecated The Python object is no longer stored in a global variable at
+    #   initialization time. Referencing this method creates a global variable in
+    #   Python's `__main__` on demand (which then stays alive until the process
+    #   exits). Use {#py_nlp} instead.
+    def spacy_nlp_id
+      @spacy_nlp_id ||= begin
+        warn "[DEPRECATION] `Spacy::Language#spacy_nlp_id` is deprecated. " \
+             "It creates a Python global variable that is never released; use `py_nlp` instead."
+        id = "nlp_#{@py_nlp.object_id}"
+        Builtins.setattr(PyMain, id, @py_nlp)
+        id
+      end
+    end
+
     # Creates a language model instance, which is conventionally referred to by a variable named `nlp`.
     # @param model [String] A language model installed in the system
+    # @param timeout [Numeric, nil] Seconds to wait for the model to load before
+    #   raising a `RuntimeError`. `nil` waits indefinitely. The timeout is
+    #   enforced on the Python side (a loading thread with `join(timeout)`)
+    #   because Ruby's `Timeout` cannot fire while PyCall holds the GVL. When it
+    #   fires, the loading thread is left running as a daemon until the process
+    #   exits (accepted: timeouts are an abnormal path).
     def initialize(model = "en_core_web_sm", max_retrial: MAX_RETRIAL, timeout: 60)
       unless model.to_s.match?(/\A[a-zA-Z0-9_\-\.\/]+\z/)
         raise ArgumentError, "Invalid model name: #{model.inspect}"
       end
 
-      @spacy_nlp_id = "nlp_#{model.object_id}"
       retrial = 0
       begin
-        Timeout.timeout(timeout) do
-          PyCall.exec("import spacy; #{@spacy_nlp_id} = spacy.load('#{model}')")
-        end
-        @py_nlp = PyCall.eval(@spacy_nlp_id)
-      rescue Timeout::Error
-        raise "PyCall execution timed out after #{timeout} seconds"
+        @py_nlp = PyHelpers.load_with_timeout(model, timeout)
       rescue StandardError => e
         retrial += 1
         if retrial <= max_retrial
@@ -528,6 +639,8 @@ module Spacy
           raise "Failed to initialize Spacy after #{max_retrial} attempts: #{e.message}"
         end
       end
+      # A timeout is not retried; it almost certainly means a hung load
+      raise "PyCall execution timed out after #{timeout} seconds" if @py_nlp.nil?
     end
 
     # Reads and analyze the given text.
@@ -554,11 +667,11 @@ module Spacy
       PhraseMatcher.new(self, attr: attr)
     end
 
-    # A utility method to lookup a vocabulary item of the given id.
-    # @param id [Integer] a vocabulary id
-    # @return [Object] a Python `Lexeme` object (https://spacy.io/api/lexeme)
+    # A utility method to lookup the string of the given vocabulary id.
+    # @param id [Integer] a vocabulary id (unsigned 64-bit values are supported)
+    # @return [String] the string corresponding to the given vocabulary id
     def vocab_string_lookup(id)
-      PyCall.eval("#{@spacy_nlp_id}.vocab.strings[#{Integer(id)}]")
+      PyHelpers.string_lookup(@py_nlp, Integer(id).to_s)
     end
 
     # A utility method to list pipeline components.
@@ -585,9 +698,9 @@ module Spacy
     # @param vector [Object] A vector representation of a word (whether existing or non-existing)
     # @return [Array<Hash{:key => Integer, :text => String, :best_rows => Array<Float>, :score => Float}>] An array of hash objects each contains the `key`, `text`, `best_row` and similarity `score` of a lexeme
     def most_similar(vector, num)
-      vec_array = Numpy.asarray([vector])
+      vec_array = PyNp.asarray([vector])
       py_result = @py_nlp.vocab.vectors.most_similar(vec_array, n: num)
-      key_texts = PyCall.eval("[[str(num), #{@spacy_nlp_id}.vocab[num].text] for num in #{py_result[0][0].tolist}]")
+      key_texts = PyCall::List.call(PyHelpers.key_texts(@py_nlp, py_result[0][0].tolist))
       keys = key_texts.map { |kt| kt[0] }
       texts = key_texts.map { |kt| kt[1] }
       best_rows = PyCall::List.call(py_result[1])[0]
@@ -618,14 +731,56 @@ module Spacy
       end
     end
 
-    # Yields an {OpenAIHelper} instance for making OpenAI API calls within a block.
+    # Yields a provider-specific LLM helper for making API calls within a block.
     # The helper is configured once and reused for all calls within the block,
     # making it efficient for batch processing with {#pipe}.
     #
+    # Providers:
+    # - +:openai+ — OpenAI API (or any OpenAI-compatible endpoint via +base_url:+).
+    #   Yields an {OpenAIHelper}.
+    # - +:anthropic+ — Anthropic (Claude) Messages API. Yields an {AnthropicHelper}.
+    # - +:ollama+ — shortcut for a local Ollama server
+    #   (+base_url: "http://localhost:11434/v1"+, no API key needed).
+    #   Yields an {OpenAIHelper}.
+    #
+    # @param provider [Symbol] :openai (default), :anthropic, or :ollama
+    # @param opts [Hash] helper options (access_token:, model:, max_tokens:,
+    #   temperature:, base_url:, ...) — see {OpenAIHelper#initialize} and
+    #   {AnthropicHelper#initialize}
+    # @yield [OpenAIHelper, AnthropicHelper] the helper instance for making API calls
+    # @return [Object] the block's return value
+    # @example Claude
+    #   nlp.with_llm(provider: :anthropic) do |ai|
+    #     ai.chat(system: "Analyze.", user: doc.linguistic_summary)
+    #   end
+    # @example Local model via Ollama
+    #   nlp.with_llm(provider: :ollama, model: "llama3.2") do |ai|
+    #     ai.chat(user: "Say hello.")
+    #   end
+    def with_llm(provider: :openai, **opts)
+      helper = case provider.to_sym
+               when :openai
+                 OpenAIHelper.new(**opts)
+               when :anthropic
+                 AnthropicHelper.new(**opts)
+               when :ollama
+                 OpenAIHelper.new(**{ base_url: "http://localhost:11434/v1",
+                                      access_token: "ollama" }.merge(opts))
+               else
+                 raise ArgumentError, "Unknown LLM provider: #{provider} (use :openai, :anthropic, or :ollama)"
+               end
+      yield helper
+    end
+
+    # Yields an {OpenAIHelper} instance for making OpenAI API calls within a block.
+    # Equivalent to {#with_llm} with +provider: :openai+.
+    #
     # @param access_token [String, nil] OpenAI API key (defaults to OPENAI_API_KEY env var)
     # @param model [String] the default model for chat requests
     # @param max_completion_tokens [Integer] default maximum tokens in responses
-    # @param temperature [Float] default sampling temperature
+    # @param temperature [Float, nil] default sampling temperature (omitted from
+    #   requests when nil)
+    # @param base_url [String, nil] OpenAI-compatible API endpoint override
     # @yield [OpenAIHelper] the helper instance for making API calls
     # @return [Object] the block's return value
     # @example Batch processing with pipe
@@ -634,13 +789,14 @@ module Spacy
     #       ai.chat(system: "Analyze.", user: doc.linguistic_summary)
     #     end
     #   end
-    def with_openai(access_token: nil, model: "gpt-5-mini",
-                    max_completion_tokens: 1000, temperature: 0.7)
+    def with_openai(access_token: nil, model: OpenAIClient::DEFAULT_MODEL,
+                    max_completion_tokens: 1000, temperature: nil, base_url: nil)
       helper = OpenAIHelper.new(
         access_token: access_token,
         model: model,
         max_completion_tokens: max_completion_tokens,
-        temperature: temperature
+        temperature: temperature,
+        base_url: base_url
       )
       yield helper
     end
@@ -660,7 +816,7 @@ module Spacy
 
     # Methods defined in Python but not wrapped in ruby-spacy can be called by this dynamic method handling mechanism.
     def method_missing(name, *args)
-      @py_nlp.send(name, *args)
+      Spacy.safe_py_send(@py_nlp, name, args)
     end
 
     def respond_to_missing?(sym, include_private = false)
@@ -692,10 +848,10 @@ module Spacy
 
     # Execute the match.
     # @param doc [Doc] an {Doc} instance
-    # @return [Array<Hash{:match_id => Integer, :start_index => Integer, :end_index => Integer}>] the id of the matched pattern, the starting position, and the end position
+    # @return [Array<Hash{:match_id => Integer, :start_index => Integer, :end_index => Integer, :label => String}>] the id of the matched pattern, the starting position, the end position, and the label string of the matched pattern
     def match(doc)
-      PyCall::List.call(@py_matcher.call(doc.py_doc)).map do |py_match|
-        { match_id: py_match[0].to_i, start_index: py_match[1].to_i, end_index: py_match[2].to_i - 1 }
+      PyCall::List.call(PyHelpers.matcher_matches(@py_matcher, doc.py_doc)).map do |py_match|
+        { match_id: py_match[0].to_i, start_index: py_match[1], end_index: py_match[2] - 1, label: py_match[3] }
       end
     end
   end
@@ -885,7 +1041,7 @@ module Spacy
 
     # Methods defined in Python but not wrapped in ruby-spacy can be called by this dynamic method handling mechanism.
     def method_missing(name, *args)
-      @py_span.send(name, *args)
+      Spacy.safe_py_send(@py_span, name, args)
     end
 
     def respond_to_missing?(sym, include_private = false)
@@ -1041,7 +1197,7 @@ module Spacy
 
     # Methods defined in Python but not wrapped in ruby-spacy can be called by this dynamic method handling mechanism.
     def method_missing(name, *args)
-      @py_token.send(name, *args)
+      Spacy.safe_py_send(@py_token, name, args)
     end
 
     def respond_to_missing?(sym, include_private = false)
@@ -1120,7 +1276,7 @@ module Spacy
 
     # Methods defined in Python but not wrapped in ruby-spacy can be called by this dynamic method handling mechanism.
     def method_missing(name, *args)
-      @py_lexeme.send(name, *args)
+      Spacy.safe_py_send(@py_lexeme, name, args)
     end
 
     def respond_to_missing?(sym, include_private = false)

data/ruby-spacy.gemspec

@@ -15,7 +15,7 @@ Gem::Specification.new do |spec|
 
   spec.homepage      = "https://github.com/yohasebe/ruby-spacy"
   spec.license       = "MIT"
-  spec.required_ruby_version = Gem::Requirement.new(">= 3.1")
+  spec.required_ruby_version = Gem::Requirement.new(">= 3.2")
 
   # Specify which files should be added to the gem when it is released.
   # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
@@ -27,15 +27,15 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
 
   spec.add_development_dependency "bundler"
+  spec.add_development_dependency "minitest"
+  spec.add_development_dependency "minitest-mock" # minitest 6 split the mock/stub support into a separate gem
   spec.add_development_dependency "rake"
-  spec.add_development_dependency "rspec"
-  spec.add_development_dependency "solargraph"
+  spec.add_development_dependency "yard"
 
   spec.add_dependency "base64" # Required for Ruby 3.4+ (moved from default to bundled gem)
   spec.add_dependency "fiddle" # Required for Ruby 4.0+ (moved from default to bundled gem)
-  spec.add_dependency "numpy", "~> 0.4.0"
-  spec.add_dependency "pycall", "~> 1.5.1"
-  spec.add_dependency "terminal-table", "~> 3.0.1"
+  spec.add_dependency "pycall", ">= 1.5.3", "< 2.0"
+  spec.add_dependency "terminal-table", ">= 3.0", "< 5"
 
   # For more information and examples about making a new gem, checkout our
   # guide at: https://bundler.io/guides/creating_gem.html

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruby-spacy
 version: !ruby/object:Gem::Version
-  version: 0.4.1
+  version: 0.6.0
 platform: ruby
 authors:
 - Yoichiro Hasebe
@@ -24,7 +24,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -38,7 +38,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rspec
+  name: minitest-mock
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -52,7 +52,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: solargraph
+  name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -66,13 +66,13 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: base64
+  name: yard
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-  type: :runtime
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
@@ -80,7 +80,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: fiddle
+  name: base64
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -94,47 +94,59 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: numpy
+  name: fiddle
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 0.4.0
+        version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 0.4.0
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: pycall
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 1.5.1
+        version: 1.5.3
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 1.5.1
+        version: 1.5.3
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: terminal-table
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.0'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: 3.0.1
+        version: '5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.0'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: 3.0.1
+        version: '5'
 description: 'ruby-spacy is a wrapper module for using spaCy from the Ruby programming
   language via PyCall. This module aims to make it easy and natural for Ruby programmers
   to use spaCy. This module covers the areas of spaCy functionality for using many
@@ -148,6 +160,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".github/FUNDING.yml"
+- ".github/workflows/ci.yml"
 - ".gitignore"
 - CHANGELOG.md
 - Gemfile
@@ -208,6 +221,9 @@ files:
 - examples/linguistic_features/similarity_between_lexemes.rb
 - examples/linguistic_features/similarity_between_spans.rb
 - examples/linguistic_features/tokenization.rb
+- examples/llm/anthropic_chat.rb
+- examples/llm/local_llm_ollama.rb
+- examples/llm/structured_ner_comparison.rb
 - examples/openai_integration/openai_completion.rb
 - examples/openai_integration/openai_embeddings.rb
 - examples/openai_integration/openai_query_1.rb
@@ -217,6 +233,9 @@ files:
 - examples/rule_based_matching/creating_spans_from_matches.rb
 - examples/rule_based_matching/matcher.rb
 - lib/ruby-spacy.rb
+- lib/ruby-spacy/anthropic_client.rb
+- lib/ruby-spacy/anthropic_helper.rb
+- lib/ruby-spacy/llm_client_base.rb
 - lib/ruby-spacy/openai_client.rb
 - lib/ruby-spacy/openai_helper.rb
 - lib/ruby-spacy/version.rb
@@ -232,7 +251,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.1'
+      version: '3.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="