girb-gemini 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: e951ec329dbfe7deddbd367e410abb158f1638af5f78a231d6570669bdc8fc5d
+  data.tar.gz: 34ec3ad651b0fbe76373c17919a6b00a0959c4a9f1faf3c8fd981228f9e49a3a
+SHA512:
+  metadata.gz: b176f9abe0e37080db7989804e7ba1e936e43eefea1ea6bd6fa1d95e0d3e85d67b7c9eb8d5c2158ec1e2aba55dbb6fba10fda68816a103ebc67445e2760aa616
+  data.tar.gz: 4f75ced680fadba2c1671362956b017afc256f657361520ccd8f0c574dbf941c5c3ae4dbd1891b7d9bcfa54d19068cd9d01df6ba9394a75c22c6f764ef018c62

data/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+## [0.1.0] - 2025-02-02
+
+### Added
+
+- Initial release
+- Google Gemini LLM provider for girb
+- Support for gemini-2.5-flash, gemini-2.5-pro, and other Gemini models
+- Auto-configuration via GEMINI_API_KEY environment variable
+- Function calling support

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Rira
+
+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,67 @@
+# girb-gemini
+
+Google Gemini LLM provider for [girb](https://github.com/rira100000000/girb) (AI-powered IRB assistant).
+
+[日本語版 README](README_ja.md)
+
+## Installation
+
+Add to your Gemfile:
+
+```ruby
+gem 'girb'
+gem 'girb-gemini'
+```
+
+Or install directly:
+
+```bash
+gem install girb girb-gemini
+```
+
+## Setup
+
+Set your API key and provider:
+
+```bash
+export GEMINI_API_KEY=your-api-key
+export GIRB_PROVIDER=girb-gemini
+```
+
+Then start girb:
+
+```bash
+girb
+```
+
+### Using with regular irb
+
+Add to your `~/.irbrc`:
+
+```ruby
+require 'girb-gemini'
+```
+
+Then use regular `irb` command.
+
+## Manual Configuration
+
+```ruby
+require 'girb-gemini'
+
+Girb.configure do |c|
+  c.provider = Girb::Providers::Gemini.new(
+    api_key: ENV['GEMINI_API_KEY'],
+    model: 'gemini-2.5-flash'  # default
+  )
+end
+```
+
+## Available Models
+
+- `gemini-2.5-flash` (default) - Fast and efficient
+- `gemini-2.5-pro` - More capable, slower
+
+## License
+
+MIT License

data/README_ja.md

@@ -0,0 +1,65 @@
+# girb-gemini
+
+[girb](https://github.com/rira100000000/girb)（AI搭載IRBアシスタント）用のGoogle Gemini LLMプロバイダー。
+
+## インストール
+
+Gemfileに追加:
+
+```ruby
+gem 'girb'
+gem 'girb-gemini'
+```
+
+または直接インストール:
+
+```bash
+gem install girb girb-gemini
+```
+
+## セットアップ
+
+APIキーとプロバイダーを設定:
+
+```bash
+export GEMINI_API_KEY=your-api-key
+export GIRB_PROVIDER=girb-gemini
+```
+
+girbを起動:
+
+```bash
+girb
+```
+
+### 通常のirbで使用する場合
+
+`~/.irbrc` に追加:
+
+```ruby
+require 'girb-gemini'
+```
+
+通常の `irb` コマンドで使用できます。
+
+## 手動設定
+
+```ruby
+require 'girb-gemini'
+
+Girb.configure do |c|
+  c.provider = Girb::Providers::Gemini.new(
+    api_key: ENV['GEMINI_API_KEY'],
+    model: 'gemini-2.5-flash'  # デフォルト
+  )
+end
+```
+
+## 利用可能なモデル
+
+- `gemini-2.5-flash` (デフォルト) - 高速で効率的
+- `gemini-2.5-pro` - より高性能、やや遅い
+
+## ライセンス
+
+MIT License

data/Rakefile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/girb-gemini.gemspec

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require_relative "lib/girb-gemini/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "girb-gemini"
+  spec.version = GirbGemini::VERSION
+  spec.authors = ["rira100000000"]
+  spec.email = ["101010hayakawa@gmail.com"]
+
+  spec.summary = "Gemini provider for girb"
+  spec.description = "Google Gemini LLM provider for girb (AI-powered IRB assistant). " \
+                     "Install this gem to use Gemini as your LLM backend."
+  spec.homepage = "https://github.com/rira100000000/girb-gemini"
+  spec.license = "MIT"
+  spec.required_ruby_version = ">= 3.2.0"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = spec.homepage
+  spec.metadata["changelog_uri"] = "#{spec.homepage}/blob/main/CHANGELOG.md"
+
+  spec.files = Dir.chdir(__dir__) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (File.expand_path(f) == __FILE__) ||
+        f.start_with?(*%w[bin/ test/ spec/ features/ .git .github appveyor Gemfile])
+    end
+  end
+  spec.require_paths = ["lib"]
+
+  # Runtime dependencies
+  spec.add_dependency "girb", "~> 0.1"
+  spec.add_dependency "ruby-gemini-api", "~> 1.0"
+end

data/lib/girb/providers/gemini.rb

@@ -0,0 +1,121 @@
+# frozen_string_literal: true
+
+require "gemini"
+require "girb/providers/base"
+
+module Girb
+  module Providers
+    class Gemini < Base
+      DEFAULT_MODEL = "gemini-2.5-flash"
+
+      def initialize(api_key:, model: DEFAULT_MODEL)
+        @client = ::Gemini::Client.new(api_key)
+        @model = model
+      end
+
+      def chat(messages:, system_prompt:, tools:)
+        contents = convert_messages(messages)
+        tools_param = build_tools_param(tools)
+
+        response = @client.chat(parameters: {
+          model: @model,
+          system_instruction: { parts: [{ text: system_prompt }] },
+          contents: contents,
+          tools: tools_param
+        }.compact)
+
+        parse_response(response)
+      rescue Faraday::BadRequestError => e
+        Response.new(error: "API Error: #{e.message}")
+      rescue StandardError => e
+        Response.new(error: "Error: #{e.message}")
+      end
+
+      private
+
+      def convert_messages(messages)
+        messages.map do |msg|
+          case msg[:role]
+          when :user
+            { role: "user", parts: [{ text: msg[:content] }] }
+          when :assistant
+            { role: "model", parts: [{ text: msg[:content] }] }
+          when :tool_call
+            {
+              role: "model",
+              parts: [{
+                function_call: {
+                  name: msg[:name],
+                  args: msg[:args]
+                }
+              }]
+            }
+          when :tool_result
+            {
+              role: "user",
+              parts: [{
+                function_response: {
+                  name: msg[:name],
+                  response: msg[:result]
+                }
+              }]
+            }
+          else
+            { role: "user", parts: [{ text: msg[:content].to_s }] }
+          end
+        end
+      end
+
+      def build_tools_param(tools)
+        return nil if tools.empty?
+
+        gemini_tools = ::Gemini::ToolDefinition.new
+
+        tools.each do |tool|
+          gemini_tools.add_function(
+            tool[:name].to_sym,
+            description: tool[:description]
+          ) do
+            properties = tool.dig(:parameters, :properties) || {}
+            required = tool.dig(:parameters, :required) || []
+
+            properties.each do |prop_name, prop_def|
+              type = prop_def[:type]&.to_sym || :string
+              desc = prop_def[:description] || ""
+              is_required = required.include?(prop_name.to_s) || required.include?(prop_name)
+
+              property prop_name, type: type, description: desc, required: is_required
+            end
+          end
+        end
+
+        declarations = gemini_tools.to_h[:function_declarations]
+        declarations ? [{ function_declarations: declarations }] : nil
+      end
+
+      def parse_response(response)
+        return Response.new(error: "No response") unless response
+
+        text = response.text
+        function_calls = parse_function_calls(response)
+
+        if response.respond_to?(:error) && response.error
+          Response.new(error: response.error, raw_response: response)
+        else
+          Response.new(text: text, function_calls: function_calls, raw_response: response)
+        end
+      end
+
+      def parse_function_calls(response)
+        return [] unless response.function_calls&.any?
+
+        response.function_calls.map do |fc|
+          {
+            name: fc["name"],
+            args: fc["args"] || {}
+          }
+        end
+      end
+    end
+  end
+end

data/lib/girb-gemini/version.rb

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

data/lib/girb-gemini.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+require "girb"
+require_relative "girb/providers/gemini"
+
+# Auto-configure Gemini provider if API key is available
+if ENV["GEMINI_API_KEY"]
+  Girb.configure do |c|
+    unless c.provider
+      c.provider = Girb::Providers::Gemini.new(
+        api_key: ENV["GEMINI_API_KEY"],
+        model: c.model || "gemini-2.5-flash"
+      )
+    end
+  end
+end

metadata

@@ -0,0 +1,81 @@
+--- !ruby/object:Gem::Specification
+name: girb-gemini
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- rira100000000
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: girb
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: ruby-gemini-api
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+description: Google Gemini LLM provider for girb (AI-powered IRB assistant). Install
+  this gem to use Gemini as your LLM backend.
+email:
+- 101010hayakawa@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- README_ja.md
+- Rakefile
+- girb-gemini.gemspec
+- lib/girb-gemini.rb
+- lib/girb-gemini/version.rb
+- lib/girb/providers/gemini.rb
+homepage: https://github.com/rira100000000/girb-gemini
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/rira100000000/girb-gemini
+  source_code_uri: https://github.com/rira100000000/girb-gemini
+  changelog_uri: https://github.com/rira100000000/girb-gemini/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.7.2
+specification_version: 4
+summary: Gemini provider for girb
+test_files: []