instructor-rb 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 65a1936ae4e512d2ec6606f592ef35be36dbf80b2013abe099056ab3048f5c7d
+  data.tar.gz: d094e3894f65f1d0062be5cfbd8e3c07bb9572f62e78425990e64c2c46e78425
+SHA512:
+  metadata.gz: 1b2eb9e6ad25aabe51a7e04d6fae1526228c362608daf00608aa0035577981e21fbe091fe138f7e09f3d9d58f062ab5f6bdc0ae77f7c88de2d95564b64191840
+  data.tar.gz: b1faeba25a79bb016becce490488d7cd06bc546ab5e7f9a1ec8c1d6d26ce3ee9115de665625a790f47b6463e280c77f4b9b90f976192e68d9b2b597dd4f88a7d

data/.rubocop.yml

@@ -0,0 +1,38 @@
+require:
+  - rubocop-rake
+  - rubocop-rspec
+
+AllCops:
+  TargetRubyVersion: 3.1
+
+Metrics/BlockLength:
+  Exclude:
+    - 'spec/**/*'
+
+Lint/ConstantDefinitionInBlock:
+  Exclude:
+    - 'spec/**/*'
+
+Layout/LineLength:
+  Exclude:
+    - 'spec/**/*'
+
+RSpec/FilePath:
+  SpecSuffixOnly: true
+
+RSpec/MultipleExpectations:
+  Max: 4
+
+RSpec/ExampleLength:
+  Max: 10
+  Exclude:
+    - spec/examples/*
+
+RSpec/DescribeClass:
+  Exclude:
+    - spec/examples/*
+    - spec/features/*
+
+RSpec/MethodLength:
+  Exclude:
+    - spec/examples/*

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 instructor
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,111 @@
+# instructor-rb
+
+_Structured extraction in Ruby, powered by llms, designed for simplicity, transparency, and control._
+
+---
+
+[![Twitter Follow](https://img.shields.io/twitter/follow/jxnlco?style=social)](https://twitter.com/jxnlco)
+[![Documentation](https://img.shields.io/badge/docs-available-brightgreen)](https://jxnl.github.io/instructor-rb)
+[![GitHub issues](https://img.shields.io/github/issues/instructor-ai/instructor-js.svg)](https://github.com/instructor-ai/instructor-rb/issues)
+[![Discord](https://img.shields.io/discord/1192334452110659664?label=discord)](https://discord.gg/CV8sPM5k5Y)
+
+Dive into the world of Ruby-based structured extraction, by OpenAI's function calling API and ActiveRecord, ruby-first schema validation with type inference. Instructor stands out for its simplicity, transparency, and user-centric design. Whether you're a seasoned developer or just starting out, you'll find Instructor's approach intuitive and steerable.
+
+> ℹ️ **Tip:**  Support in other languages
+
+    Check out ports to other languages below:
+
+    - [Python](https://www.github.com/jxnl/instructor)
+    - [TS/JS](https://github.com/instructor-ai/instructor-js/)
+    - [Ruby](https://github.com/instructor-ai/instructor-rb)
+    - [Elixir](https://github.com/thmsmlr/instructor_ex/)
+
+    If you want to port Instructor to another language, please reach out to us on [Twitter](https://twitter.com/jxnlco) we'd love to help you get started!
+
+## Usage
+
+export your OpenAI API key:
+
+```bash
+export OPENAI_API_KEY=sk-...
+```
+
+Then use Instructor to extract structured data from text in Ruby:
+
+```ruby
+require 'instructor'
+
+class UserDetail
+  include EasyTalk::Model
+
+  define_schema do
+    property :name, String
+    property :age, Integer
+  end
+end
+
+client = Instructor.patch(OpenAI::Client).new
+
+user = client.chat(
+  parameters: {
+    model: 'gpt-3.5-turbo',
+    messages: [{ role: 'user', content: 'Extract Jason is 25 years old' }]
+  },
+  response_model: UserDetail
+)
+
+puts(user.inspect)
+{"name"=>"Jason", "age"=>25}
+```
+
+## Why use Instructor?
+
+
+1. **OpenAI Integration** — Integrates seamlessly with OpenAI's API, facilitating efficient data management and manipulation.
+
+2. **Customizable** — It offers significant flexibility. Users can tailor validation processes and define unique error messages.
+
+3. **Widespread Adoption** — As a primary component in Ruby on Rails, it's widely used and backed by a substantial community.
+
+4. **Tested and Trusted** — Its reliability is proven by extensive real-world application, underscored by its high adoption rate in Ruby-based projects.
+
+## More Examples
+
+If you'd like to see more check out our [cookbook](examples/index.md).
+
+[Installing Instructor](installation.md) is a breeze. 
+
+## Contributing
+
+If you want to help out, checkout some of the issues marked as `good-first-issue` or `help-wanted`. Found [here](https://github.com/instructor-ai/instructor-js/labels/good%20first%20issue). They could be anything from code improvements, a guest blog post, or a new cook book.
+
+Checkout the [contribution guide]() for details on how to set things up, testing, changesets and guidelines.
+
+## License
+
+This project is licensed under the terms of the MIT License.
+
+## TODO
+- [ ] Add patch
+  - [ ] Mode.FUNCTIONS
+  - [ ] Mode.TOOLS
+  - [ ] Mode.MD_JSON
+  - [ ] Mode.JSON
+- [ ] Add response_model
+- [ ] Support async
+- [ ] Support stream=True, Partial[T] and iterable[T]
+- [ ] Support Streaming
+- [ ] Optional/Maybe types
+- [ ] Add Tutorials, include in docs
+    - [ ] Text Classification
+    - [ ] Search Queries
+    - [ ] Query Decomposition
+    - [ ] Citations
+    - [ ] Knowledge Graph
+    - [ ] Self Critique
+    - [ ] Image Extracting Tables
+    - [ ] Moderation
+    - [ ] Entity Resolution
+    - [ ] Action Item and Dependency Mapping
+- [ ] Logging for Distillation / Finetuning
+- [ ] Add `llm_validator`

data/Rakefile

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+require 'rubocop/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+RuboCop::RakeTask.new
+
+task default: %i[spec rubocop]

data/bin/console

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'bundler/setup'
+require 'instructor'
+
+require 'irb'
+IRB.start(__FILE__)

data/ellipsis.Dockerfile

@@ -0,0 +1,12 @@
+#======================================
+# This Dockerfile was generated by Ellipsis.
+# It should be referenced from your `ellipsis.yaml` config file.
+# For more details, see documentation: https://docs.ellipsis.dev
+# Test with:      $ docker build -f ellipsis.Dockerfile .
+#======================================
+
+FROM ubuntu:20.04
+RUN apt-get update && apt-get install -y     git     build-essential
+
+WORKDIR /app
+COPY . .

data/ellipsis.yaml

@@ -0,0 +1,38 @@
+# See https://docs.ellipsis.dev for all available configurations.
+
+version: 1.1
+pr_review:
+  auto_review_enabled: true  # enable auto-review of PRs
+  auto_summarize_pr: true  # enable auto-summary of PRs
+  confidence_threshold: 0.5  # Threshold for how confident Ellipsis needs to be in order to leave a comment, in range [0.0-1.0]
+  rules:  # customize behavior
+    - "Code should be DRY (Don't Repeat Yourself)"
+    - "There should no secrets or credentials in the code"
+
+  # users can customize their own behavior
+  user_overrides:
+    # @hbrooks has disabled auto-summary and added a custom rule
+    - usernames: ["hbrooks"]
+      auto_summarize_pr: false
+      rules:
+        - "Code should be DRY (Don't Repeat Yourself)"
+
+
+# Below is an example of how to configure Ellipsis to build and run your repo.
+# Uncomment and replace with your own Dockerfile and commands.
+
+dockerfile: "ellipsis.Dockerfile"  # this will be used to build your repo
+
+#=======================
+# commands: 
+#   - name: "build"
+#     description: "This command compiles the code and builds the project"
+#     command: "yarn build"
+#     return_output_on_success: false  # If output isn't useful when the command succeeds
+#     auto_repair: true  # Run this after every code change
+#   - name: "lint_fix"
+#     description: "Lints the code in fix mode, which will fix some errors."
+#     command: "yarn lint:fix"
+#     return_output_on_success: false
+#     auto_repair: true
+#=======================

data/lib/instructor/openai/patch.rb

@@ -0,0 +1,144 @@
+# frozen_string_literal: true
+
+# The Instructor module provides functionality for interacting with OpenAI's chat API.
+module Instructor
+  module OpenAI
+    # The `Patch` module provides methods for patching and modifying the OpenAI client behavior.
+    module Patch
+      # Executes a block of code with retries in case of specific exceptions.
+      #
+      # @param max_retries [Integer] The maximum number of retries.
+      # @param exceptions [Array<Class>] The exceptions to catch and retry.
+      # @yield The block of code to execute.
+      def with_retries(max_retries, exceptions, &block)
+        attempts = 0
+        begin
+          block.call
+        rescue *exceptions
+          attempts += 1
+          retry if attempts < max_retries
+          raise
+        end
+      end
+
+      # Sends a chat request to the API and processes the response.
+      #
+      # @param parameters [Hash] The parameters for the chat request as expected by the OpenAI client.
+      # @param response_model [Class] The response model class.
+      # @param max_retries [Integer] The maximum number of retries. Default is 0.
+      # @param validation_context [Hash] The validation context for the parameters. Optional.
+      # @return [Object] The processed response.
+      def chat(parameters:, response_model: nil, max_retries: 0, validation_context: nil)
+        with_retries(max_retries, [JSON::ParserError, Instructor::ValidationError, Faraday::ParsingError]) do
+          model = determine_model(response_model)
+          function = build_function(model)
+          parameters = prepare_parameters(parameters, validation_context, function)
+          response = json_post(path: '/chat/completions', parameters:)
+          process_response(response, model)
+        end
+      end
+
+      # Prepares the parameters for the chat request.
+      #
+      # @param parameters [Hash] The original parameters.
+      # @param validation_context [Hash] The validation context for the parameters.
+      # @param function [Hash] The function details.
+      # @return [Hash] The prepared parameters.
+      def prepare_parameters(parameters, validation_context, function)
+        parameters = apply_validation_context(parameters, validation_context)
+        parameters.merge(tools: [function])
+      end
+
+      # Processes the API response.
+      #
+      # @param response [Hash] The API response.
+      # @param model [Class] The response model class.
+      # @return [Object] The processed response.
+      def process_response(response, model)
+        parsed_response = Response.new(response).parse
+        iterable? ? process_multiple_responses(parsed_response, model) : process_single_response(parsed_response, model)
+      end
+
+      # Processes multiple responses from the API.
+      #
+      # @param parsed_response [Array<Hash>] The parsed API responses.
+      # @param model [Class] The response model class.
+      # @return [Array<Object>] The processed responses.
+      def process_multiple_responses(parsed_response, model)
+        parsed_response.map do |response|
+          instance = model.new(response)
+          instance.valid? ? instance : raise(Instructor::ValidationError)
+        end
+      end
+
+      # Processes a single response from the API.
+      #
+      # @param parsed_response [Hash] The parsed API response.
+      # @param model [Class] The response model class.
+      # @return [Object] The processed response.
+      def process_single_response(parsed_response, model)
+        instance = model.new(parsed_response)
+        instance.valid? ? instance : raise(Instructor::ValidationError)
+      end
+
+      # Determines the response model based on the provided value.
+      #
+      # @param response_model [Class] The response model class or typed array.
+      # @return [Class] The determined response model class.
+      def determine_model(response_model)
+        if response_model.is_a?(T::Types::TypedArray)
+          @iterable = true
+          response_model.type.raw_type
+        else
+          @iterable = false
+          response_model
+        end
+      end
+
+      # Applies the validation context to the parameters.
+      #
+      # @param parameters [Hash] The original parameters.
+      # @param validation_context [Hash] The validation context.
+      # @return [Hash] The parameters with applied validation context.
+      def apply_validation_context(parameters, validation_context)
+        return parameters unless validation_context.is_a?(Hash)
+
+        Array[validation_context].each_with_index do |message, index|
+          parameters[:messages][index][:content] = parameters[:messages][index][:content] % message
+        end
+
+        parameters
+      end
+
+      # Builds the function details for the API request.
+      #
+      # @param model [Class] The response model class.
+      # @return [Hash] The function details.
+      def build_function(model)
+        {
+          type: 'function',
+          function: {
+            name: model.name.humanize.titleize,
+            description: generate_description(model),
+            parameters: model.json_schema
+          }
+        }
+      end
+
+      # Generates the description for the function.
+      #
+      # @param model [Class] The response model class.
+      # @return [String] The generated description.
+      def generate_description(model)
+        "Correctly extracted `#{model.name}` with all the required parameters with correct types"
+      end
+
+      # Checks if the response is iterable.
+      #
+      # @return [Boolean] `true` if the response is iterable, `false` otherwise.
+      def iterable?
+        @iterable
+      end
+    end
+  end
+end

data/lib/instructor/openai/response.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+module Instructor
+  module OpenAI
+    # The Response class represents the response received from the OpenAI API.
+    # It takes the raw response and provides convenience methods to access the chat completions,
+    # tool calls, function responses, and parsed arguments.
+    class Response
+      # Initializes a new instance of the Response class.
+      #
+      # @param response [Hash] The response received from the OpenAI API.
+      def initialize(response)
+        @response = response
+      end
+
+      # Returns the chat completions from the response.
+      #
+      # @return [Array] An array of chat completions.
+      def chat_completions
+        @response['choices']
+      end
+
+      # Returns the tool calls from the chat completions.
+      #
+      # @return [Hash, nil] The tool calls or nil if not found.
+      def tool_calls
+        chat_completions&.dig(0, 'message', 'tool_calls')
+      end
+
+      # Returns the function responses from the tool calls.
+      #
+      # @return [Array, nil] An array of function responses or nil if not found.
+      def function_responses
+        tool_calls&.map { |tool_call| tool_call['function'] }
+      end
+
+      # Returns the first function response.
+      #
+      # @return [Hash, nil] The first function response or nil if not found.
+      def function_response
+        function_responses&.first
+      end
+
+      # Checks if there is only a single function response.
+      #
+      # @return [Boolean] True if there is only a single function response, false otherwise.
+      def single_response?
+        function_responses&.size == 1
+      end
+
+      # Parses the function response(s) and returns the parsed arguments.
+      #
+      # @return [Array, Hash] The parsed arguments.
+      def parse
+        if single_response?
+          JSON.parse(function_response['arguments'])
+        else
+          function_responses.map { |res| JSON.parse(res['arguments']) }
+        end
+      end
+
+      # Returns the arguments of the function with the specified name.
+      #
+      # @param function_name [String] The name of the function.
+      # @return [Hash, nil] The arguments of the function or nil if not found.
+      def by_function_name(function_name)
+        function_responses&.find { |res| res['name'] == function_name }&.dig('arguments')
+      end
+    end
+  end
+end

data/lib/instructor/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Instructor
+  VERSION = '0.1.0'
+end

data/lib/instructor.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require 'openai'
+require 'easy_talk'
+require 'active_support/all'
+require_relative 'instructor/version'
+require_relative 'instructor/openai/patch'
+require_relative 'instructor/openai/response'
+
+# Instructor makes it easy to reliably get structured data like JSON from Large Language Models (LLMs)
+# like GPT-3.5, GPT-4, GPT-4-Vision
+module Instructor
+  class Error < ::StandardError; end
+
+  # The ValidationError class represents an error that occurs during validation.
+  class ValidationError < ::StandardError; end
+
+  # Patches the OpenAI client to add the following functionality:
+  # - Retries on exceptions
+  # - Accepts and validates a response model
+  # - Accepts a validation_context argument
+  #
+  # @param openai_client [OpenAI::Client] The OpenAI client to be patched.
+  # @return [OpenAI::Client] The patched OpenAI client.
+  def self.patch(openai_client)
+    openai_client.prepend(Instructor::OpenAI::Patch)
+  end
+end

metadata

@@ -0,0 +1,229 @@
+--- !ruby/object:Gem::Specification
+name: instructor-rb
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Sergio Bayona
+- Jason Liu
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2024-04-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '7.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '7.0'
+- !ruby/object:Gem::Dependency
+  name: easy_talk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.8
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.8
+- !ruby/object:Gem::Dependency
+  name: ruby-openai
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6'
+- !ruby/object:Gem::Dependency
+  name: pry-byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.10'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.1'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rspec-json_expectations
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.21'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.21'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.29'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.29'
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+description: Explore the power of LLM structured extraction in Ruby with the Instructor
+  gem.
+email:
+- bayona.sergio@gmail.com
+- jason@jxnl.co
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rubocop.yml"
+- LICENSE
+- README.md
+- Rakefile
+- bin/console
+- ellipsis.Dockerfile
+- ellipsis.yaml
+- lib/instructor.rb
+- lib/instructor/openai/patch.rb
+- lib/instructor/openai/response.rb
+- lib/instructor/version.rb
+homepage: https://github.com/instructor-ai/instructor-rb
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/instructor-ai/instructor-rb
+  source_code_uri: https://github.com/instructor-ai/instructor-rb
+  changelog_uri: https://github.com/instructor-ai/instructor-rb/blob/main/CHANGELOG.md
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.9
+signing_key:
+specification_version: 4
+summary: Structured extraction in Ruby, powered by llms.
+test_files: []