simple_llm 0.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 41fa4b4f324b9c18eea8b5325d740b3575148f636fc681479a99d656d2b292a7
+  data.tar.gz: 02b7447deb5930df1119b7576495e92ac93e502bd2d8a83690a83ddd384be4f9
+SHA512:
+  metadata.gz: a49b36d277ed58c279094c4af2e2af35af02c8788a6709bb1c1df108e66cdcff0fc7ddccdc2b86c94eeec54d3eaf5e022bc712de16ec68ba40528fb2894f9d27
+  data.tar.gz: 47538a761188bb5364d851e80a18b8a261272f36e97fa814d24a92b152678e4e5e7338cc433a2b5b4d4ced7a647d69b8587314e8ad9b4fdc942a95b879a23efd

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Victor Maslov
+
+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/lib/simple_llm.rb

@@ -0,0 +1,94 @@
+require_relative "refinement_array"
+using ::RefinementArray
+
+module SimpleLLM
+  require "nethttputils"
+
+  Error = ::Class.new ::RuntimeError
+
+  module Common
+
+    require "skjvs"
+    # @param cache_filename [String, nil, false] если передать `nil` или `false`, кеширования не будет
+    def initialize cache_filename = "simple_llm_cache.jsonl", &cache_key_string_function
+      @cache_key_string_function = cache_key_string_function || lambda do |
+        cls,
+        time,
+        auth,
+        pid,
+        model,
+        input,
+        max_output_tokens,
+        temperature,
+        instructions,
+      |
+        "#{instructions} #{input}"
+      end
+      @cache = ::SKJVS::OneFile.new cache_filename if cache_filename
+    end
+
+  end
+
+  module Yandex
+
+    class Sync
+      require "json"
+      require "digest"
+      include Common
+      # TODO: ассертить размер input-а при image_input как-то иначе
+      # https://aistudio.yandex.ru/docs/ru/ai-studio/api/Responses/createResponse.html
+      # @param project
+      # @param api_key
+      # @param input [Object] https://aistudio.yandex.ru/docs/ru/ai-studio/api/Responses/createResponse.html#entity-InputParam
+      # @param max_output_tokens [Integer] "An upper bound for the number of tokens that can be generated for a response, including visible output tokens and reasoning tokens."
+      # @param temperature [Integer] "What sampling temperature to use, between 0 and 2. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic."
+      # @param model [String]
+      # @param instructions
+      # @param max_input_chars [Integer] предохранительный ассерт, чтобы метод не вызвали со слишком тяжелым большим input-ом
+      # @param debug [true, false] печатать запросы и ответы
+      # @return [String] текст из `["output"]["content"][0]["text"]`
+      def call project, api_key, input, max_output_tokens = 500, temperature = 0, model: "yandexgpt/rc", instructions: nil, max_input_chars: 1000, debug: false
+        raise ::ArgumentError, "max_input_chars assertion: #{input.to_s.size}" if input.to_s.size > max_input_chars
+        request = lambda do
+          ::NetHTTPUtils.request_data(
+            "https://ai.api.cloud.yandex.net/v1/responses", :post, :json, header: {
+              "OpenAI-Project" => project,
+              "Authorization" => "Api-Key #{api_key}",
+              "x-data-logging-enabled" => "false",  # https://aistudio.yandex.ru/docs/ru/ai-studio/operations/disable-logging.html
+            }, form: {
+              model: "gpt://#{project}/#{model}",
+              instructions: instructions,
+              input: input,
+              temperature: temperature,
+              max_output_tokens: max_output_tokens,
+              # reasoning: {effort: "low"},
+            }.compact.tap{ |_| ::STDERR.puts ::JSON.pretty_generate _ if debug }
+          ).force_encoding("utf-8")
+        end
+        ::JSON.parse(
+          if @cache
+            @cache[ @cache_key_string_function.(
+          self.class,
+          ::Time.now,
+          ::Digest::MD5.hexdigest(api_key),
+          ::Process::pid,
+          model,
+          input,
+          max_output_tokens,
+          temperature,
+          instructions,
+            ) ] ||= request.call
+          else
+            request.call
+          end
+        ).tap{ |_| ::STDERR.puts ::JSON.pretty_generate _ if debug }["output"].select{ |_| "message" == _["type"] }.map do |message|
+          message["content"].assert_one.fetch("text").strip
+        end.assert_one_or_less or raise Error, "empty message assertion"
+      end
+    end
+
+    # class Async
+
+  end
+
+end

data/simple_llm.gemspec

@@ -0,0 +1,15 @@
+Gem::Specification.new do |spec|
+  spec.name         = "simple_llm"
+  spec.version      = "0.0.0"
+  spec.summary      = "common wrapper for all LLM providers"
+
+  spec.author       = "Victor Maslov aka Nakilon"
+  spec.email        = "nakilon@gmail.com"
+  spec.license      = "MIT"
+  spec.metadata     = {"source_code_uri" => "https://github.com/nakilon/simple_llm"}
+
+  spec.add_dependency "nethttputils"
+  spec.add_dependency "skjvs"
+
+  spec.files        = %w{ LICENSE simple_llm.gemspec lib/simple_llm.rb }
+end

metadata

@@ -0,0 +1,74 @@
+--- !ruby/object:Gem::Specification
+name: simple_llm
+version: !ruby/object:Gem::Version
+  version: 0.0.0
+platform: ruby
+authors:
+- Victor Maslov aka Nakilon
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-07-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: nethttputils
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: skjvs
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description:
+email: nakilon@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- lib/simple_llm.rb
+- simple_llm.gemspec
+homepage:
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/nakilon/simple_llm
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.6
+signing_key:
+specification_version: 4
+summary: common wrapper for all LLM providers
+test_files: []