ruby_llm-providers-apfel 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 691f6aca0f671994fe947ed562e4b35720453513152f8b5d959023266679bc97
+  data.tar.gz: 87e2c3d286eb1e31575cfc661a66f95015a36fc5f5a39ed02404e82925a86043
+SHA512:
+  metadata.gz: 6db0f5d2633e80c9897733b133b77fdd472dfad063449a4b10361788ae2b7192649f8a440922a926c1404025b7654301c2291bbb8c9124fbd352d0831c742d3c
+  data.tar.gz: 3178067325ab285c5b62e8bd1e78ed32c65990b9fbd509ed4b8a0cabcf06dedebe83f4db8b21850da37b71a43498dd3d69265ceb30a100cd498c6e77c1e7a835

data/.flayignore

@@ -0,0 +1 @@
+spec/support/streaming_error_helpers.rb

data/.github/workflows/ci.yml

@@ -0,0 +1,32 @@
+name: CI
+
+on:
+  pull_request:
+    branches: ["main"]
+  push:
+    branches: ["main"]
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: Ruby ${{ matrix.ruby-version }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby-version: ["3.1", "3.2", "3.3", "3.4", "4.0"]
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby-version }}
+          bundler-cache: true
+
+      - run: bundle exec rake
+        if: matrix.ruby-version != '3.1'
+
+      - run: bundle exec rake rubocop flay spec
+        if: matrix.ruby-version == '3.1'

data/.github/workflows/gitleaks.yml

@@ -0,0 +1,22 @@
+name: Gitleaks
+
+on:
+  pull_request:
+    branches: ["main"]
+  push:
+    branches: ["main"]
+
+permissions:
+  contents: read
+
+jobs:
+  scan:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - uses: gitleaks/gitleaks-action@v2
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

data/.github/workflows/release.yml

@@ -0,0 +1,36 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: read
+
+jobs:
+  publish:
+    name: Build and publish
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.4"
+          bundler-cache: true
+
+      - run: bundle exec rake
+
+      - name: Build gem
+        run: gem build ruby_llm-providers-apfel.gemspec
+
+      - name: Publish to RubyGems
+        run: |
+          mkdir -p "$HOME/.gem"
+          touch "$HOME/.gem/credentials"
+          chmod 0600 "$HOME/.gem/credentials"
+          printf -- "---\n:rubygems_api_key: ${GEM_HOST_API_KEY}\n" > "$HOME/.gem/credentials"
+          gem push ruby_llm-providers-apfel-*.gem
+        env:
+          GEM_HOST_API_KEY: ${{ secrets.RUBYGEMS_AUTH_TOKEN }}

data/.overcommit.yml

@@ -0,0 +1,31 @@
+PreCommit:
+  RuboCop:
+    enabled: true
+    auto_correct: true
+    on_warn: fail
+
+  Flay:
+    enabled: true
+    include:
+      - lib/**/*.rb
+      - spec/**/*.rb
+    mass_threshold: 70
+
+  ArchSpec:
+    enabled: true
+    command: ['bundle', 'exec', 'archspec', 'check']
+    on_warn: fail
+
+  RSpec:
+    enabled: true
+    command: ['bundle', 'exec', 'rspec']
+    on_warn: fail
+
+  TrailingWhitespace:
+    enabled: true
+    auto_correct: true
+
+  Gitleaks:
+    enabled: true
+    required_executable: gitleaks
+    command: ['gitleaks', 'protect', '--staged', '--redact', '--verbose']

data/.rspec

@@ -0,0 +1,2 @@
+--require spec_helper
+--format progress

data/.rubocop.yml

@@ -0,0 +1,29 @@
+plugins:
+  - rubocop-performance
+  - rubocop-rake
+  - rubocop-rspec
+
+AllCops:
+  NewCops: enable
+  TargetRubyVersion: 3.1
+  Exclude:
+    - Archspec.rb
+    - vendor/**/*
+    - gemfiles/**/*
+  SuggestExtensions: false
+
+Metrics/AbcSize:
+  Max: 80
+Metrics/MethodLength:
+  Max: 40
+  CountAsOne:
+    - array
+    - hash
+    - heredoc
+Metrics/BlockLength:
+  Exclude:
+    - spec/**/*.rb
+RSpec/ExampleLength:
+  Enabled: false
+RSpec/MultipleExpectations:
+  Enabled: false

data/Archspec.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+source 'lib/**/*.rb'
+
+component :provider,
+          in: %w[
+            lib/ruby_llm/providers/apfel.rb
+            lib/ruby_llm/providers/apfel/**/*.rb
+          ],
+          namespace: 'RubyLLM::Providers::Apfel'
+
+provider.cannot_reference_constants 'RSpec', 'WebMock', 'VCR'
+
+preset :ruby_conventions

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 your-github-org
+
+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,85 @@
+# ruby_llm-providers-apfel
+
+RubyLLM provider gem for [Apfel](https://apfel.franzai.com/), a CLI tool that exposes Apple's
+on-device Foundation Models framework through an OpenAI-compatible HTTP server. With Apfel and
+this gem, RubyLLM can talk to Apple's on-device model (AFM) as a fully local, offline LLM
+provider — no API key, no cloud calls, no per-token billing.
+
+## Requirements
+
+- Apple Silicon Mac (M-series)
+- macOS 26 (Tahoe) or later
+- Apple Intelligence enabled
+
+## Installing Apfel
+
+Apfel itself is a separate Homebrew package, not a Ruby gem. Install it once per machine:
+
+```sh
+brew install apfel
+```
+
+Start it as a local OpenAI-compatible server:
+
+```sh
+apfel --serve
+```
+
+By default the server listens at `http://127.0.0.1:11434/v1`. Authentication is optional — pass
+`--token <value>` to `apfel --serve` if you want to require a Bearer token; otherwise no API key
+is needed at all.
+
+Apfel serves Apple's on-device Foundation Model (AFM, ~3B parameters) running entirely on the
+Neural Engine. It has a combined input/output context window of 4,096 tokens, so keep prompts and
+expected responses within that budget.
+
+## Installing the gem
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'ruby_llm-providers-apfel', require: 'ruby_llm/providers/apfel'
+```
+
+Then configure the provider to point at your local Apfel server:
+
+```ruby
+require 'ruby_llm/providers/apfel'
+
+RubyLLM.configure do |config|
+  config.apfel_api_base = ENV.fetch('APFEL_API_BASE', 'http://127.0.0.1:11434/v1')
+  # Only needed if you started `apfel --serve --token <value>`
+  config.apfel_api_key = ENV['APFEL_API_KEY']
+end
+```
+
+Since Apfel runs locally with no API key required, `apfel_api_key` can be left unset unless you
+started the server with `--token`.
+
+## Usage
+
+```ruby
+model = RubyLLM.models.by_provider(:apfel).chat_models.first
+chat = RubyLLM.chat(model: model.id)
+response = chat.ask('Hello')
+puts response.content
+```
+
+## Development
+
+The generator installs the bundle and creates an ignored `.env`. Edit the generated `op read` reference so it points to your 1Password credential. If you do not use the 1Password CLI, replace the expression with the provider key.
+
+```sh
+bundle exec rake models
+bundle exec rake
+```
+
+`rake models` calls only Apfel's model-listing endpoint and writes `models.json` at the gem root. RubyLLM loads that catalog as a fallback when this provider is registered, so applications do not need to combine registry files. The main RubyLLM registry always wins when both catalogs carry the same model. If the API uses a different path, change `models_url` in `lib/ruby_llm/providers/apfel.rb`.
+
+Run `rake models` from this provider gem when you want to update its packaged catalog. `RubyLLM.models.refresh` updates the application's main registry and does not refresh provider gem catalogs.
+
+If the provider has no model-listing endpoint, uncomment `assume_models_exist?` in the provider and do not run `rake models`.
+
+The suite always runs the provider integration specs. The first local run calls the API and records VCR cassettes; CI only replays committed cassettes. A failing example deletes its cassette so the next local run tests the live API again.
+
+After refreshing the catalog, add real model IDs to `spec/support/models.rb`. Keep only the operation matrices the provider supports. The portable contract specs are adapted from [RubyLLM's live specs](https://github.com/crmne/ruby_llm/tree/main/spec/ruby_llm); use those as the reference when your provider needs coverage for another feature or dialect.

data/lib/ruby_llm/providers/apfel/connection_guard.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require 'delegate'
+
+module RubyLLM
+  module Providers
+    class Apfel < Provider
+      # Wraps the transport connection so a request against a server that
+      # is not running surfaces as a RubyLLM::Error explaining how to start
+      # Apfel, instead of a raw Faraday::ConnectionFailed.
+      class ConnectionGuard < SimpleDelegator
+        %i[get post patch delete].each do |verb|
+          define_method(verb) do |*args, **kwargs, &block|
+            __getobj__.public_send(verb, *args, **kwargs, &block)
+          rescue Faraday::ConnectionFailed
+            raise Error, unreachable_message
+          end
+        end
+
+        def unreachable_message
+          "Could not connect to the Apfel server at #{provider.api_base}. " \
+            'Install it with `brew install apfel` if needed, then start it with `apfel --serve`, ' \
+            'and try again.'
+        end
+      end
+    end
+  end
+end

data/lib/ruby_llm/providers/apfel/version.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module RubyLLM
+  module Providers
+    # Version of the ruby_llm-providers-apfel gem. Kept in its own file so the
+    # gemspec can read the literal without loading the provider.
+    class Apfel < Provider
+      VERSION = '0.1.0'
+
+      def self.version
+        VERSION
+      end
+    end
+  end
+end

data/lib/ruby_llm/providers/apfel.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+require 'ruby_llm'
+require 'ruby_llm/providers/apfel/version'
+require 'ruby_llm/providers/apfel/connection_guard'
+
+module RubyLLM
+  module Providers
+    # Apfel API integration.
+    class Apfel < Provider
+      # Apfel's ChatCompletions protocol.
+      class ChatCompletions < Protocols::ChatCompletions
+        def models_url
+          'models'
+        end
+      end
+
+      protocol :chat_completions, ChatCompletions
+
+      def initialize(config)
+        super
+        @connection = ConnectionGuard.new(@connection)
+      end
+
+      def api_base
+        @config.apfel_api_base || 'https://api.example.com/v1'
+      end
+
+      def headers
+        { 'Authorization' => "Bearer #{@config.apfel_api_key}" }
+      end
+
+      class << self
+        def configuration_options
+          %i[apfel_api_key apfel_api_base]
+        end
+
+        def configuration_requirements
+          %i[apfel_api_key]
+        end
+
+        # Use this only when the provider has no model-listing endpoint.
+        # def assume_models_exist?
+        #   true
+        # end
+      end
+    end
+  end
+end
+
+RubyLLM::Provider.register :apfel, RubyLLM::Providers::Apfel,
+                           models: File.expand_path('../../../models.json', __dir__)

data/spec/ruby_llm/chat_schema_spec.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe RubyLLM::Chat, :live do
+  include_context 'with configured RubyLLM'
+
+  let(:person_schema) do
+    {
+      type: 'object',
+      properties: {
+        name: { type: 'string' },
+        age: { type: 'integer' }
+      },
+      required: %w[name age],
+      additionalProperties: false
+    }
+  end
+
+  each_model(STRUCTURED_OUTPUT_MODELS) do |provider, model|
+    it "#{provider}/#{model} returns structured output" do
+      response = RubyLLM.chat(model: model, provider: provider, assume_model_exists: true)
+                        .with_schema(person_schema)
+                        .ask('Generate a person named John who is 30 years old')
+
+      expect(response.content).to be_a(String)
+      expect(response.parsed).to include('name' => 'John', 'age' => 30)
+    end
+  end
+end

data/spec/ruby_llm/chat_spec.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe RubyLLM::Chat, :live do
+  include_context 'with configured RubyLLM'
+
+  each_model(CHAT_MODELS) do |provider, model|
+    it "#{provider}/#{model} can have a basic conversation" do
+      response = RubyLLM.chat(model: model, provider: provider, assume_model_exists: true).ask("What's 2 + 2?")
+
+      expect(response.content).to include('4')
+      expect(response.role).to eq(:assistant)
+      expect(response.tokens.input.to_i).to be_positive
+      expect(response.tokens.output.to_i).to be_positive
+    end
+
+    it "#{provider}/#{model} returns the raw response" do
+      response = RubyLLM.chat(model: model, provider: provider, assume_model_exists: true)
+                        .ask('What is the capital of France?')
+
+      expect(response.raw.status).to eq(200)
+      expect(response.raw.headers).not_to be_empty
+      expect(response.raw.body).not_to be_empty
+      expect(response.raw.env.request_body).not_to be_empty
+    end
+
+    it "#{provider}/#{model} can handle a multi-turn conversation" do
+      chat = RubyLLM.chat(model: model, provider: provider, assume_model_exists: true)
+
+      expect(chat.ask('Who created the programming language Ruby?').content).to match(/Matz|Matsumoto/i)
+      expect(chat.ask('What year was Ruby first released?').content).to include('199')
+    end
+  end
+end

data/spec/ruby_llm/chat_streaming_spec.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe RubyLLM::Chat, :live do
+  include_context 'with configured RubyLLM'
+
+  each_model(CHAT_MODELS) do |provider, model|
+    it "#{provider}/#{model} supports streaming responses" do
+      chunks = []
+      chat = RubyLLM.chat(model: model, provider: provider, assume_model_exists: true)
+
+      response = chat.ask('Count from 1 to 3') { |chunk| chunks << chunk }
+
+      expect(chunks).not_to be_empty
+      expect(chunks.first).to be_a(RubyLLM::Chunk)
+      expect(response.raw.status).to eq(200)
+      expect(response.raw.headers).not_to be_empty
+      expect(response.raw.env.request_body).not_to be_empty
+    end
+  end
+end

data/spec/ruby_llm/chat_tools_spec.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe RubyLLM::Chat, :live do
+  include_context 'with configured RubyLLM'
+
+  let(:weather_tool) do
+    Class.new(RubyLLM::Tool) do
+      description 'Gets current weather for a location'
+      parameter :latitude, description: 'Latitude'
+      parameter :longitude, description: 'Longitude'
+
+      def execute(latitude:, longitude:)
+        "Current weather at #{latitude}, #{longitude}: 15°C, Wind: 10 km/h"
+      end
+    end
+  end
+
+  each_model(TOOL_MODELS) do |provider, model|
+    it "#{provider}/#{model} can use tools" do
+      chat = RubyLLM.chat(model: model, provider: provider, assume_model_exists: true).with_tools(weather_tool)
+      response = chat.ask("What's the weather in Berlin? Use 52.5200, 13.4050.")
+
+      expect(response.content).to include('15')
+      expect(response.content).to include('10')
+      expect(chat.messages.any?(&:tool_call?)).to be(true)
+    end
+  end
+end

data/spec/ruby_llm/embedding_spec.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe RubyLLM::Embedding, :live do
+  include_context 'with configured RubyLLM'
+
+  each_model(EMBEDDING_MODELS) do |provider, model, model_info|
+    it "#{provider}/#{model} embeds one text" do
+      embedding = RubyLLM.embed(
+        "Ruby is a programmer's best friend",
+        model: model,
+        provider: provider,
+        assume_model_exists: true
+      )
+
+      expect(embedding.vectors).to be_an(Array)
+      expect(embedding.vectors.first).to be_a(Numeric)
+      expect(embedding.model).to eq(model)
+      expect(embedding.tokens.input.to_i).to be >= 0
+    end
+
+    it "#{provider}/#{model} embeds several texts" do
+      embeddings = RubyLLM.embed(
+        %w[Ruby Python JavaScript],
+        model: model,
+        provider: provider,
+        assume_model_exists: true
+      )
+
+      expect(embeddings.vectors.size).to eq(3)
+      expect(embeddings.vectors).to all(be_an(Array))
+    end
+
+    next unless model_info[:dimensions]
+
+    it "#{provider}/#{model} supports custom dimensions" do
+      embedding = RubyLLM.embed(
+        'Ruby',
+        model: model,
+        provider: provider,
+        assume_model_exists: true,
+        dimensions: model_info[:dimensions]
+      )
+
+      expect(embedding.vectors.length).to eq(model_info[:dimensions])
+    end
+  end
+end

data/spec/ruby_llm/image_spec.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe RubyLLM::Image, :live do
+  include_context 'with configured RubyLLM'
+
+  each_model(IMAGE_GENERATION_MODELS) do |provider, model, model_info|
+    it "#{provider}/#{model} paints an image" do
+      image = RubyLLM.paint(
+        'a siamese cat',
+        model: model,
+        provider: provider,
+        assume_model_exists: true,
+        provider_options: model_info.fetch(:provider_options, {})
+      )
+
+      expect(image.mime_type).to include('image')
+      expect(image.model).to eq(model)
+      expect(image.to_blob.bytesize).to be > 1000
+    end
+  end
+end

data/spec/ruby_llm/models_spec.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe RubyLLM::Models do
+  include_context 'with configured RubyLLM'
+
+  it 'expects generated providers to add registry metadata before use' do
+    expect(RubyLLM::Providers::Apfel.assume_models_exist?).to be(false)
+  end
+end

data/spec/ruby_llm/moderation_spec.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe RubyLLM::Moderation, :live do
+  include_context 'with configured RubyLLM'
+
+  each_model(MODERATION_MODELS) do |provider, model|
+    it "#{provider}/#{model} moderates content" do
+      moderation = RubyLLM.moderate(
+        'This is a safe message',
+        model: model,
+        provider: provider,
+        assume_model_exists: true
+      )
+
+      expect(moderation).to be_a(described_class)
+      expect(moderation.results).to all(be_a(RubyLLM::Moderation::Result))
+      expect(moderation.flagged?).to be_in([true, false])
+    end
+  end
+end

data/spec/ruby_llm/providers/apfel_spec.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe RubyLLM::Providers::Apfel do
+  subject(:provider) { described_class.new(config) }
+
+  let(:config) do
+    RubyLLM::Configuration.new.tap do |provider_config|
+      provider_config.apfel_api_key = 'test-key'
+      provider_config.apfel_api_base = 'https://example.test/v1'
+    end
+  end
+
+  it 'is registered with RubyLLM' do
+    expect(RubyLLM::Provider.resolve(:apfel)).to eq(described_class)
+  end
+
+  it 'registers a default protocol' do
+    expect(described_class.protocols).to include(chat_completions: described_class::ChatCompletions)
+  end
+
+  it 'declares provider configuration' do
+    expect(described_class.configuration_options).to eq(%i[apfel_api_key apfel_api_base])
+    expect(described_class.configuration_requirements).to eq(%i[apfel_api_key])
+  end
+
+  it 'uses configured API base and bearer token' do
+    expect(provider.api_base).to eq('https://example.test/v1')
+    expect(provider.headers).to eq('Authorization' => 'Bearer test-key')
+  end
+end

data/spec/ruby_llm/rerank_spec.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe RubyLLM::Rerank, :live do
+  include_context 'with configured RubyLLM'
+
+  each_model(RERANK_MODELS) do |provider, model|
+    it "#{provider}/#{model} orders documents by relevance" do
+      rerank = RubyLLM.rerank(
+        'What is the capital of the United States?',
+        ['Carson City is the capital of Nevada.', 'Washington, D.C. is the capital of the United States.'],
+        model: model,
+        provider: provider,
+        assume_model_exists: true
+      )
+
+      expect(rerank.results.first.document).to include('Washington')
+      expect(rerank.results.first.score).to be > rerank.results.last.score
+      expect(rerank.results.map(&:index)).to contain_exactly(0, 1)
+    end
+  end
+end

data/spec/ruby_llm/speech_spec.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe RubyLLM::Speech, :live do
+  include_context 'with configured RubyLLM'
+
+  each_model(SPEECH_MODELS) do |provider, model, model_info|
+    it "#{provider}/#{model} speaks" do
+      speech = RubyLLM.speak(
+        'Ruby is a programming language designed for developer happiness.',
+        model: model,
+        provider: provider,
+        assume_model_exists: true,
+        voice: model_info[:voice],
+        format: model_info[:format]
+      )
+
+      expect(speech.data).to be_a(String)
+      expect(speech.data.bytesize).to be > 1000
+      expect(speech.model).to eq(model)
+      expect(speech.mime_type).to start_with('audio/')
+    end
+  end
+end

data/spec/ruby_llm/video_spec.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe RubyLLM::Video, :live do
+  include_context 'with configured RubyLLM'
+
+  before do
+    RubyLLM.config.video_generation_poll_interval = VCR.current_cassette&.recording? ? 5 : 0
+  end
+
+  each_model(VIDEO_GENERATION_MODELS) do |provider, model, model_info|
+    it "#{provider}/#{model} animates a video" do
+      video = RubyLLM.animate(
+        'a calm ocean wave at sunset',
+        model: model,
+        provider: provider,
+        assume_model_exists: true,
+        provider_options: model_info.fetch(:provider_options, {})
+      )
+
+      expect(video.mime_type).to include('video')
+      expect(video.url || video.data).not_to be_nil
+      expect(video.to_blob.bytesize).to be > 10_000
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require 'bundler/setup'
+require 'dotenv/load'
+require 'fileutils'
+
+require 'vcr'
+require 'ruby_llm/providers/apfel'
+require 'webmock/rspec'
+
+Dir[File.expand_path('support/**/*.rb', __dir__)].each { |file| require file }
+
+RSpec.configure do |config|
+  config.disable_monkey_patching!
+  config.expect_with(:rspec) { |expectations| expectations.syntax = :expect }
+  config.order = :random
+  Kernel.srand config.seed
+
+  config.around(:each, :live) do |example|
+    cassette_name = example.full_description.downcase.gsub(/[^a-z0-9]+/, '_').delete_prefix('_').delete_suffix('_')
+    cassette_path = File.join(VCR.configuration.cassette_library_dir, "#{cassette_name}.yml")
+
+    VCR.use_cassette(cassette_name) { example.run }
+    FileUtils.rm_f(cassette_path) if example.exception
+  end
+end

data/spec/support/models.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+# Remove chat-derived matrices the model does not support and add real ids for the empty operation matrices.
+# See RubyLLM's full live matrix and specs: https://github.com/crmne/ruby_llm/tree/main/spec
+PROVIDER = :apfel
+CHAT_MODELS = [].freeze
+TOOL_MODELS = CHAT_MODELS
+STRUCTURED_OUTPUT_MODELS = CHAT_MODELS
+
+EMBEDDING_MODELS = [].freeze
+IMAGE_GENERATION_MODELS = [].freeze
+SPEECH_MODELS = [].freeze
+VIDEO_GENERATION_MODELS = [].freeze
+MODERATION_MODELS = [].freeze
+RERANK_MODELS = [].freeze
+
+def each_model(models)
+  models.each { |model_info| yield model_info[:provider], model_info[:model], model_info }
+end

data/spec/support/rubyllm_configuration.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+RSpec.shared_context 'with configured RubyLLM' do
+  before do
+    RubyLLM.configure do |config|
+      config.apfel_api_key = ENV.fetch('APFEL_API_KEY', 'test')
+      config.apfel_api_base = ENV.fetch('APFEL_API_BASE', 'https://api.example.com/v1')
+      config.max_retries = 0
+      config.retry_backoff_factor = 0
+      config.retry_interval = 0
+      config.retry_interval_randomness = 0
+    end
+  end
+end

data/spec/support/vcr_configuration.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+VCR.configure do |config|
+  config.cassette_library_dir = 'spec/fixtures/vcr_cassettes'
+  config.hook_into :webmock
+  config.default_cassette_options = { record: ENV['CI'] ? :none : :once }
+  config.allow_http_connections_when_no_cassette = true
+  config.filter_sensitive_data('<APFEL_API_KEY>') { ENV.fetch('APFEL_API_KEY', nil) }
+  config.filter_sensitive_data('<APFEL_API_BASE>') { ENV.fetch('APFEL_API_BASE', nil) }
+
+  config.before_record do |interaction|
+    next unless interaction.request.headers['Authorization']
+
+    interaction.request.headers['Authorization'] = ['Bearer <AUTH_TOKEN>']
+  end
+end

metadata

@@ -0,0 +1,90 @@
+--- !ruby/object:Gem::Specification
+name: ruby_llm-providers-apfel
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- madbomber
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ruby_llm
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.0.0.rc1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.0.0.rc1
+description: Adds Apfel provider support to RubyLLM. Apfel is a macOS-only local server
+  that exposes Apple's on-device Apple Intelligence model over an OpenAI-compatible
+  API, letting RubyLLM talk to it like any other provider.
+email:
+- dvanhoozer@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".flayignore"
+- ".github/workflows/ci.yml"
+- ".github/workflows/gitleaks.yml"
+- ".github/workflows/release.yml"
+- ".overcommit.yml"
+- ".rspec"
+- ".rubocop.yml"
+- Archspec.rb
+- LICENSE
+- README.md
+- lib/ruby_llm/providers/apfel.rb
+- lib/ruby_llm/providers/apfel/connection_guard.rb
+- lib/ruby_llm/providers/apfel/version.rb
+- spec/ruby_llm/chat_schema_spec.rb
+- spec/ruby_llm/chat_spec.rb
+- spec/ruby_llm/chat_streaming_spec.rb
+- spec/ruby_llm/chat_tools_spec.rb
+- spec/ruby_llm/embedding_spec.rb
+- spec/ruby_llm/image_spec.rb
+- spec/ruby_llm/models_spec.rb
+- spec/ruby_llm/moderation_spec.rb
+- spec/ruby_llm/providers/apfel_spec.rb
+- spec/ruby_llm/rerank_spec.rb
+- spec/ruby_llm/speech_spec.rb
+- spec/ruby_llm/video_spec.rb
+- spec/spec_helper.rb
+- spec/support/models.rb
+- spec/support/rubyllm_configuration.rb
+- spec/support/vcr_configuration.rb
+homepage: https://github.com/madbomber/ruby_llm-providers-apfel
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/madbomber/ruby_llm-providers-apfel
+  source_code_uri: https://github.com/madbomber/ruby_llm-providers-apfel
+  changelog_uri: https://github.com/madbomber/ruby_llm-providers-apfel/releases
+  bug_tracker_uri: https://github.com/madbomber/ruby_llm-providers-apfel/issues
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.1'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.20
+specification_version: 4
+summary: RubyLLM provider for Apfel.
+test_files: []