llm.rb 0.4.0 → 0.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3d8311b461c49095ba393be6d3456bf7c3032a07e4480f4fd3e4cd9133f2b6e7
-  data.tar.gz: 5f9ce812a4a27e0982ea5072bca3f0494317ee0274987e57df792cc0e0d2fcfc
+  metadata.gz: 46af7f9487355b1ad33501bdc2602f2bfbb9ac3a7a3377eb601d367167373b69
+  data.tar.gz: f1bb4dc1b423e5335d19540c664af714d523ecded97476fb379711f2015fa93a
 SHA512:
-  metadata.gz: 1d860cabe75a0718e0c06d686127d6d24c65b4dc8967aaf490b892bfad10bf88268791e9138b26e2d1c646a22e2eda7e74ad48e1fa31e9cb68c42de7ec53ac12
-  data.tar.gz: 8c2e14a316e87560e5d5dc3cdb416d151172ae12e2244bb813ff1bba61c582474607bd6920f82fa5f080e628b2dac319dd20d4f74eff55940f9c88ab7544b327
+  metadata.gz: b249df823bedda3041df65b4f17b861d7529737855c2395dbcb978838098eecb0950ec935e06f290d9737f7b780c64a42cd21bf54e8077360947c1e70c3bad04
+  data.tar.gz: 0a35370e5cd41488dfcbc05259c28ac906e1a3b217f4882aebfb87a8ee5b9d04ca771df9ed77d32efc0782510bc35c33db7a0704a81841ae1b8f9d832d5f3af7

data/LICENSE

@@ -0,0 +1,17 @@
+Copyright (C) 2025
+Antar Azri <azantar@proton.me>
+0x1eef <0x1eef@proton.me>
+
+Permission to use, copy, modify, and/or distribute this
+software for any purpose with or without fee is hereby
+granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS
+ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO
+EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER
+RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,
+ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
+OF THIS SOFTWARE.

data/lib/llm/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module LLM
-  VERSION = "0.4.0"
+  VERSION = "0.4.1"
 end

data/llm.gemspec

@@ -21,10 +21,9 @@ Gem::Specification.new do |spec|
   spec.metadata["source_code_uri"] = "https://github.com/llmrb/llm"
 
   spec.files = Dir[
-    "README.md", "LICENSE.txt",
+    "README.md", "LICENSE",
     "lib/*.rb", "lib/**/*.rb",
-    "spec/*.rb", "spec/**/*.rb",
-    "share/llm/models/*.yml", "llm.gemspec"
+    "llm.gemspec"
   ]
   spec.require_paths = ["lib"]
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: llm.rb
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.4.1
 platform: ruby
 authors:
 - Antar Azri
@@ -147,6 +147,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- LICENSE
 - README.md
 - lib/json/schema.rb
 - lib/json/schema/array.rb
@@ -213,29 +214,6 @@ files:
 - lib/llm/utils.rb
 - lib/llm/version.rb
 - llm.gemspec
-- spec/anthropic/completion_spec.rb
-- spec/anthropic/embedding_spec.rb
-- spec/anthropic/models_spec.rb
-- spec/gemini/completion_spec.rb
-- spec/gemini/conversation_spec.rb
-- spec/gemini/embedding_spec.rb
-- spec/gemini/files_spec.rb
-- spec/gemini/images_spec.rb
-- spec/gemini/models_spec.rb
-- spec/llm/conversation_spec.rb
-- spec/ollama/completion_spec.rb
-- spec/ollama/conversation_spec.rb
-- spec/ollama/embedding_spec.rb
-- spec/ollama/models_spec.rb
-- spec/openai/audio_spec.rb
-- spec/openai/completion_spec.rb
-- spec/openai/embedding_spec.rb
-- spec/openai/files_spec.rb
-- spec/openai/images_spec.rb
-- spec/openai/models_spec.rb
-- spec/openai/responses_spec.rb
-- spec/readme_spec.rb
-- spec/setup.rb
 homepage: https://github.com/llmrb/llm
 licenses:
 - 0BSDL

data/spec/anthropic/completion_spec.rb

@@ -1,96 +0,0 @@
-# frozen_string_literal: true
-
-require "setup"
-
-RSpec.describe "LLM::Anthropic: completions" do
-  subject(:anthropic) { LLM.anthropic(token) }
-  let(:token) { ENV["LLM_SECRET"] || "TOKEN" }
-
-  context "when given a successful response",
-          vcr: {cassette_name: "anthropic/completions/successful_response"} do
-    subject(:response) { anthropic.complete("Hello, world", :user) }
-
-    it "returns a completion" do
-      expect(response).to be_a(LLM::Response::Completion)
-    end
-
-    it "returns a model" do
-      expect(response.model).to eq("claude-3-5-sonnet-20240620")
-    end
-
-    it "includes token usage" do
-      expect(response).to have_attributes(
-        prompt_tokens: 10,
-        completion_tokens: 30,
-        total_tokens: 40
-      )
-    end
-
-    context "with a choice" do
-      subject(:choice) { response.choices[0] }
-
-      it "has choices" do
-        expect(choice).to have_attributes(
-          role: "assistant",
-          content: "Hello! How can I assist you today? Feel free to ask me any questions or let me know if you need help with anything."
-        )
-      end
-
-      it "includes the response" do
-        expect(choice.extra[:response]).to eq(response)
-      end
-    end
-  end
-
-  context "when given a URI to an image",
-          vcr: {cassette_name: "anthropic/completions/successful_response_uri_image"} do
-    subject { response.choices[0].content.downcase[0..2] }
-    let(:response) do
-      anthropic.complete([
-        "Is this image the flag of brazil ? ",
-        "Answer with yes or no. ",
-        "Nothing else.",
-        uri
-      ], :user)
-    end
-    let(:uri) { URI("https://upload.wikimedia.org/wikipedia/en/thumb/0/05/Flag_of_Brazil.svg/250px-Flag_of_Brazil.svg.png") }
-
-    it "describes the image" do
-      is_expected.to eq("yes")
-    end
-  end
-
-  context "when given a local reference to an image",
-          vcr: {cassette_name: "anthropic/completions/successful_response_file_image"} do
-    subject { response.choices[0].content.downcase[0..2] }
-    let(:response) do
-      anthropic.complete([
-        "Is this image a representation of a blue book ?",
-        "Answer with yes or no.",
-        "Nothing else.",
-        file
-      ], :user)
-    end
-    let(:file) { LLM::File("spec/fixtures/images/bluebook.png") }
-
-    it "describes the image" do
-      is_expected.to eq("yes")
-    end
-  end
-
-  context "when given an unauthorized response",
-          vcr: {cassette_name: "anthropic/completions/unauthorized_response"} do
-    subject(:response) { anthropic.complete("Hello", :user) }
-    let(:token) { "BADTOKEN" }
-
-    it "raises an error" do
-      expect { response }.to raise_error(LLM::Error::Unauthorized)
-    end
-
-    it "includes the response" do
-      response
-    rescue LLM::Error::Unauthorized => ex
-      expect(ex.response).to be_kind_of(Net::HTTPResponse)
-    end
-  end
-end

data/spec/anthropic/embedding_spec.rb

@@ -1,25 +0,0 @@
-# frozen_string_literal: true
-
-require "setup"
-
-RSpec.describe "LLM::Anthropic: embeddings" do
-  let(:anthropic) { LLM.anthropic(token) }
-  let(:token) { ENV["LLM_SECRET"] || "TOKEN" }
-
-  context "when given a successful response",
-          vcr: {cassette_name: "anthropic/embeddings/successful_response"} do
-    subject(:response) { anthropic.embed("Hello, world", token:) }
-
-    it "returns an embedding" do
-      expect(response).to be_instance_of(LLM::Response::Embedding)
-    end
-
-    it "returns a model" do
-      expect(response.model).to eq("voyage-2")
-    end
-
-    it "has embeddings" do
-      expect(response.embeddings).to be_instance_of(Array)
-    end
-  end
-end

data/spec/anthropic/models_spec.rb

@@ -1,21 +0,0 @@
-# frozen_string_literal: true
-
-require "setup"
-
-RSpec.describe "LLM::Anthropic::Models" do
-  let(:token) { ENV["LLM_SECRET"] || "TOKEN" }
-  let(:provider) { LLM.anthropic(token) }
-
-  context "when given a successful list operation",
-          vcr: {cassette_name: "anthropic/models/successful_list"} do
-    subject { provider.models.all }
-
-    it "is successful" do
-      is_expected.to be_instance_of(LLM::Response::ModelList)
-    end
-
-    it "returns a list of models" do
-      expect(subject.models).to all(be_a(LLM::Model))
-    end
-  end
-end

data/spec/gemini/completion_spec.rb

@@ -1,85 +0,0 @@
-# frozen_string_literal: true
-
-require "setup"
-
-RSpec.describe "LLM::Gemini: completions" do
-  subject(:gemini) { LLM.gemini(token) }
-  let(:token) { ENV["LLM_SECRET"] || "TOKEN" }
-
-  context "when given a successful response",
-          vcr: {cassette_name: "gemini/completions/successful_response"} do
-    subject(:response) { gemini.complete("Hello!", :user) }
-
-    it "returns a completion" do
-      expect(response).to be_a(LLM::Response::Completion)
-    end
-
-    it "returns a model" do
-      expect(response.model).to eq("gemini-1.5-flash")
-    end
-
-    it "includes token usage" do
-      expect(response).to have_attributes(
-        prompt_tokens: 2,
-        completion_tokens: 11,
-        total_tokens: 13
-      )
-    end
-
-    context "with a choice" do
-      subject(:choice) { response.choices[0] }
-
-      it "has choices" do
-        expect(response).to be_a(LLM::Response::Completion).and have_attributes(
-          choices: [
-            have_attributes(
-              role: "model",
-              content: "Hello there! How can I help you today?\n"
-            )
-          ]
-        )
-      end
-
-      it "includes the response" do
-        expect(choice.extra[:response]).to eq(response)
-      end
-    end
-  end
-
-  context "when given a thread of messages",
-          vcr: {cassette_name: "gemini/completions/successful_response_thread"} do
-    subject(:response) do
-      gemini.complete "What is your name? What age are you?", :user, messages: [
-        {role: "user", content: "Answer all of my questions"},
-        {role: "user", content: "Your name is Pablo, you are 25 years old and you are my amigo"}
-      ]
-    end
-
-    it "has choices" do
-      expect(response).to have_attributes(
-        choices: [
-          have_attributes(
-            role: "model",
-            content: "My name is Pablo, and I am 25 years old.  ¡Amigo!\n"
-          )
-        ]
-      )
-    end
-  end
-
-  context "when given an unauthorized response",
-          vcr: {cassette_name: "gemini/completions/unauthorized_response"} do
-    subject(:response) { gemini.complete("Hello!", :user) }
-    let(:token) { "BADTOKEN" }
-
-    it "raises an error" do
-      expect { response }.to raise_error(LLM::Error::Unauthorized)
-    end
-
-    it "includes a response" do
-      response
-    rescue LLM::Error::Unauthorized => ex
-      expect(ex.response).to be_kind_of(Net::HTTPResponse)
-    end
-  end
-end

data/spec/gemini/conversation_spec.rb

@@ -1,31 +0,0 @@
-# frozen_string_literal: true
-
-require "setup"
-
-RSpec.describe "LLM::Chat: gemini" do
-  let(:described_class) { LLM::Chat }
-  let(:provider) { LLM.gemini(token) }
-  let(:token) { ENV["LLM_SECRET"] || "TOKEN" }
-  let(:conversation) { described_class.new(provider, **params).lazy }
-
-  context "when asked to describe an image",
-          vcr: {cassette_name: "gemini/conversations/multimodal_response"} do
-    subject { conversation.last_message }
-
-    let(:params) { {} }
-    let(:image) { LLM::File("spec/fixtures/images/bluebook.png") }
-
-    before do
-      conversation.chat(image, :user)
-      conversation.chat("Describe the image with a short sentance", :user)
-    end
-
-    it "describes the image" do
-      is_expected.to have_attributes(
-        role: "model",
-        content: "That's a simple illustration of a book " \
-                 "resting on a blue, X-shaped book stand.\n"
-      )
-    end
-  end
-end

data/spec/gemini/embedding_spec.rb

@@ -1,25 +0,0 @@
-# frozen_string_literal: true
-
-require "setup"
-
-RSpec.describe "LLM::OpenAI: embeddings" do
-  let(:gemini) { LLM.gemini(token) }
-  let(:token) { ENV["LLM_SECRET"] || "TOKEN" }
-
-  context "when given a successful response",
-          vcr: {cassette_name: "gemini/embeddings/successful_response"} do
-    subject(:response) { gemini.embed("Hello, world") }
-
-    it "returns an embedding" do
-      expect(response).to be_instance_of(LLM::Response::Embedding)
-    end
-
-    it "returns a model" do
-      expect(response.model).to eq("text-embedding-004")
-    end
-
-    it "has embeddings" do
-      expect(response.embeddings).to be_instance_of(Array)
-    end
-  end
-end

data/spec/gemini/files_spec.rb

@@ -1,124 +0,0 @@
-# frozen_string_literal: true
-
-require "setup"
-
-RSpec.describe "LLM::Gemini::Files" do
-  let(:token) { ENV["LLM_SECRET"] || "TOKEN" }
-  let(:provider) { LLM.gemini(token) }
-
-  context "when given a successful create operation (bismillah.mp3)",
-          vcr: {cassette_name: "gemini/files/successful_create_bismillah"} do
-    subject(:file) { provider.files.create(file: LLM::File("spec/fixtures/audio/bismillah.mp3")) }
-    after { provider.files.delete(file:) }
-
-    it "is successful" do
-      expect(file).to be_instance_of(LLM::Response::File)
-    end
-
-    it "returns a file object" do
-      expect(file).to have_attributes(
-        name: instance_of(String),
-        display_name: "bismillah.mp3"
-      )
-    end
-  end
-
-  context "when given a successful delete operation (bismillah.mp3)",
-          vcr: {cassette_name: "gemini/files/successful_delete_bismillah"} do
-    let(:file) { provider.files.create(file: LLM::File("spec/fixtures/audio/bismillah.mp3")) }
-    subject { provider.files.delete(file:) }
-
-    it "is successful" do
-      is_expected.to be_instance_of(Net::HTTPOK)
-    end
-  end
-
-  context "when given a successful get operation (bismillah.mp3)",
-          vcr: {cassette_name: "gemini/files/successful_get_bismillah"} do
-    let(:file) { provider.files.create(file: LLM::File("spec/fixtures/audio/bismillah.mp3")) }
-    subject { provider.files.get(file:) }
-    after { provider.files.delete(file:) }
-
-    it "is successful" do
-      is_expected.to be_instance_of(LLM::Response::File)
-    end
-
-    it "returns a file object" do
-      is_expected.to have_attributes(
-        name: instance_of(String),
-        display_name: "bismillah.mp3"
-      )
-    end
-  end
-
-  context "when given a successful translation operation (bismillah.mp3)",
-          vcr: {cassette_name: "gemini/files/successful_translation_bismillah"} do
-    subject { bot.last_message.content }
-    let(:file) { provider.files.create(file: LLM::File("spec/fixtures/audio/bismillah.mp3")) }
-    let(:bot) { LLM::Chat.new(provider).lazy }
-    after { provider.files.delete(file:) }
-
-    before do
-      bot.chat file
-      bot.chat "Translate the contents of the audio file into English"
-      bot.chat "The audio is referenced in the first message I sent to you"
-      bot.chat "Provide no other content except the translation"
-    end
-
-    it "translates the audio clip" do
-      is_expected.to eq("In the name of Allah, the Most Gracious, the Most Merciful.\n")
-    end
-  end
-
-  context "when given a successful translation operation (alhamdullilah.mp3)",
-          vcr: {cassette_name: "gemini/files/successful_translation_alhamdullilah"} do
-    subject { bot.last_message.content }
-    let(:file) { provider.files.create(file: LLM::File("spec/fixtures/audio/alhamdullilah.mp3")) }
-    let(:bot) { LLM::Chat.new(provider).lazy }
-    after { provider.files.delete(file:) }
-
-    before do
-      bot.chat [
-        "Translate the contents of the audio file into English",
-        "Provide no other content except the translation",
-        file
-      ]
-    end
-
-    it "translates the audio clip" do
-      is_expected.to eq("All praise is due to Allah, Lord of the worlds.\n")
-    end
-  end
-
-  context "when given a successful all operation",
-          vcr: {cassette_name: "gemini/files/successful_all"} do
-    let!(:files) do
-      [
-        provider.files.create(file: LLM::File("spec/fixtures/audio/bismillah.mp3")),
-        provider.files.create(file: LLM::File("spec/fixtures/audio/alhamdullilah.mp3"))
-      ]
-    end
-
-    subject(:response) { provider.files.all }
-    after { files.each { |file| provider.files.delete(file:) } }
-
-    it "is successful" do
-      expect(response).to be_instance_of(LLM::Response::FileList)
-    end
-
-    it "returns an array of file objects" do
-      expect(response).to match_array(
-        [
-          have_attributes(
-            name: instance_of(String),
-            display_name: "bismillah.mp3"
-          ),
-          have_attributes(
-            name: instance_of(String),
-            display_name: "alhamdullilah.mp3"
-          )
-        ]
-      )
-    end
-  end
-end

data/spec/gemini/images_spec.rb

@@ -1,39 +0,0 @@
-# frozen_string_literal: true
-
-require "setup"
-
-RSpec.describe "LLM::Gemini::Images" do
-  let(:token) { ENV["LLM_SECRET"] || "TOKEN" }
-  let(:provider) { LLM.gemini(token) }
-
-  context "when given a successful create operation",
-        vcr: {cassette_name: "gemini/images/successful_create"} do
-    subject(:response) { provider.images.create(prompt: "A dog on a rocket to the moon") }
-
-    it "is successful" do
-      expect(response).to be_instance_of(LLM::Response::Image)
-    end
-
-    it "returns an IO-like object" do
-      expect(response.images[0]).to be_instance_of(StringIO)
-    end
-  end
-
-  context "when given a successful edit operation",
-        vcr: {cassette_name: "gemini/images/successful_edit"} do
-    subject(:response) do
-      provider.images.edit(
-        image: LLM::File("spec/fixtures/images/bluebook.png"),
-        prompt: "Book is floating in the clouds"
-      )
-    end
-
-    it "is successful" do
-      expect(response).to be_instance_of(LLM::Response::Image)
-    end
-
-    it "returns an IO-like object" do
-      expect(response.images[0]).to be_instance_of(StringIO)
-    end
-  end
-end

data/spec/gemini/models_spec.rb

@@ -1,21 +0,0 @@
-# frozen_string_literal: true
-
-require "setup"
-
-RSpec.describe "LLM::Gemini::Models" do
-  let(:token) { ENV["LLM_SECRET"] || "TOKEN" }
-  let(:provider) { LLM.gemini(token) }
-
-  context "when given a successful list operation",
-          vcr: {cassette_name: "gemini/models/successful_list"} do
-    subject { provider.models.all }
-
-    it "is successful" do
-      is_expected.to be_instance_of(LLM::Response::ModelList)
-    end
-
-    it "returns a list of models" do
-      expect(subject.models).to all(be_a(LLM::Model))
-    end
-  end
-end