girb-ruby_llm 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a587322ce50087756c3a8e0178062385ea59f83737fb8b9c70816777024b230a
-  data.tar.gz: 165288aad6307d5e658abc4f0385409752bab2f35b2e0cc9fe81f9a0f0fac05d
+  metadata.gz: 66f01e57eaba72b64b36e0621eabd8c01251ebf92baacd82b738332867e5f6e8
+  data.tar.gz: fa63bea432ab5e4d36be4253df606c526c1b0920e1e22e4ca6b2929a7f837cdc
 SHA512:
-  metadata.gz: 15a8df02dcec847a6c884d7ffc099cb9c9a7bfa484d210b8796102ef60e6a2029828f1efdfe343fefec2196f889fb467eb2d0921cd28468b4d27f317a6a72645
-  data.tar.gz: 2cded93009f453527579f0cf9b1ba9c356760bb3f6dabb63b7aea122172a12d6454294d0a7b9a5f3d1972a8f92f65871e174dbf744d3ed19ffa36984d4308f3c
+  metadata.gz: 0a94d28c70c59bb44802dd7932b5a33e46e488bad840cdf4b3666070353d61058b501135e58edc7baea4ca0d4fe6a0dc93bdf19491452d768eca1e968f54510d
+  data.tar.gz: d0e28049f1c2eb77f30a0e1ede71d39af6d96b1e96975986fd4803805cc982b2f1bfec6301646a574a3261e366617c2c819aa38e1e7d23e11f4986a1b997b2f7

data/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## [0.1.1] - 2026-02-03
+
+### Added
+
+- GIRB_MODEL environment variable support (required)
+- Auto-refresh models for local providers (Ollama, GPUStack)
+
+### Changed
+
+- Recommend ~/.irbrc configuration instead of environment variables
+
 ## [0.1.0] - 2025-02-02
 
 ### Added

data/README.md

@@ -23,28 +23,33 @@ gem install girb girb-ruby_llm
 
 ## Setup
 
-Set the provider and your API key:
+### Option 1: Configure in ~/.irbrc (Recommended)
 
-```bash
-export GIRB_PROVIDER=girb-ruby_llm
-export GEMINI_API_KEY=your-api-key  # or other provider's API key
-```
+Add to your `~/.irbrc`:
+
+```ruby
+require 'girb-ruby_llm'
 
-Then start girb:
+RubyLLM.configure do |config|
+  config.gemini_api_key = 'your-api-key'
+end
 
-```bash
-girb
+Girb.configure do |c|
+  c.provider = Girb::Providers::RubyLlm.new(model: 'gemini-2.5-flash')
+end
 ```
 
-### Using with regular irb
+Then use regular `irb` command.
 
-Add to your `~/.irbrc`:
+### Option 2: Configure via environment variables
 
-```ruby
-require 'girb-ruby_llm'
+```bash
+export GIRB_PROVIDER=girb-ruby_llm
+export GIRB_MODEL=gemini-2.5-flash
+export GEMINI_API_KEY=your-api-key
 ```
 
-Then use regular `irb` command.
+Then start with `girb` command.
 
 ## Configuration
 
@@ -89,6 +94,7 @@ Set your API key or endpoint as an environment variable:
 
 ```bash
 export GIRB_PROVIDER=girb-ruby_llm
+export GIRB_MODEL=gpt-4o
 export OPENAI_API_KEY="sk-..."
 girb
 ```
@@ -97,6 +103,7 @@ girb
 
 ```bash
 export GIRB_PROVIDER=girb-ruby_llm
+export GIRB_MODEL=claude-sonnet-4-20250514
 export ANTHROPIC_API_KEY="sk-ant-..."
 girb
 ```
@@ -107,8 +114,9 @@ girb
 # Start Ollama first
 ollama serve
 
-# Set the provider and API base URL
+# Set the provider, model, and API base URL
 export GIRB_PROVIDER=girb-ruby_llm
+export GIRB_MODEL=llama3.2:latest
 export OLLAMA_API_BASE="http://localhost:11434/v1"
 girb
 ```
@@ -117,29 +125,30 @@ girb
 
 ```bash
 export GIRB_PROVIDER=girb-ruby_llm
+export GIRB_MODEL=your-model-name
 export OPENAI_API_KEY="not-needed"  # Some require any non-empty value
 export OPENAI_API_BASE="http://localhost:1234/v1"
 girb
 ```
 
-### Manual Configuration
+### Advanced Configuration
 
-You can configure the provider manually in your `~/.irbrc`:
+For more control, configure Girb in your `~/.irbrc`:
 
 ```ruby
 # ~/.irbrc
 require 'girb-ruby_llm'
 
-RubyLLM.configure do |config|
-  config.ollama_api_base = "http://localhost:11434/v1"
-end
-RubyLLM::Models.refresh!
-
 Girb.configure do |c|
-  c.provider = Girb::Providers::RubyLlm.new(model: 'llama3.2:latest')
+  c.debug = true  # Enable debug output
+  c.custom_prompt = <<~PROMPT
+    Always confirm before destructive operations.
+  PROMPT
 end
 ```
 
+Note: `RubyLLM::Models.refresh!` is automatically called for local providers (Ollama, GPUStack).
+
 ## Supported Models
 
 See [RubyLLM Available Models](https://rubyllm.com/reference/available-models) for the full list of supported models.

data/README_ja.md

@@ -21,28 +21,33 @@ gem install girb girb-ruby_llm
 
 ## セットアップ
 
-プロバイダーとAPIキーを設定:
+### 方法1: ~/.irbrcで設定（推奨）
 
-```bash
-export GIRB_PROVIDER=girb-ruby_llm
-export GEMINI_API_KEY=your-api-key  # または他のプロバイダーのAPIキー
-```
+`~/.irbrc` に追加:
+
+```ruby
+require 'girb-ruby_llm'
 
-girbを起動:
+RubyLLM.configure do |config|
+  config.gemini_api_key = 'your-api-key'
+end
 
-```bash
-girb
+Girb.configure do |c|
+  c.provider = Girb::Providers::RubyLlm.new(model: 'gemini-2.5-flash')
+end
 ```
 
-### 通常のirbで使用する場合
+通常の `irb` コマンドで使用できます。
 
-`~/.irbrc` に追加:
+### 方法2: 環境変数で設定
 
-```ruby
-require 'girb-ruby_llm'
+```bash
+export GIRB_PROVIDER=girb-ruby_llm
+export GIRB_MODEL=gemini-2.5-flash
+export GEMINI_API_KEY=your-api-key
 ```
 
-通常の `irb` コマンドで使用できます。
+`girb` コマンドで起動します。
 
 ## 設定
 
@@ -87,6 +92,7 @@ APIキーまたはエンドポイントを環境変数として設定します:
 
 ```bash
 export GIRB_PROVIDER=girb-ruby_llm
+export GIRB_MODEL=gpt-4o
 export OPENAI_API_KEY="sk-..."
 girb
 ```
@@ -95,6 +101,7 @@ girb
 
 ```bash
 export GIRB_PROVIDER=girb-ruby_llm
+export GIRB_MODEL=claude-sonnet-4-20250514
 export ANTHROPIC_API_KEY="sk-ant-..."
 girb
 ```
@@ -105,8 +112,9 @@ girb
 # まずOllamaを起動
 ollama serve
 
-# プロバイダーとAPIベースURLを設定
+# プロバイダー、モデル、APIベースURLを設定
 export GIRB_PROVIDER=girb-ruby_llm
+export GIRB_MODEL=llama3.2:latest
 export OLLAMA_API_BASE="http://localhost:11434/v1"
 girb
 ```
@@ -115,29 +123,30 @@ girb
 
 ```bash
 export GIRB_PROVIDER=girb-ruby_llm
+export GIRB_MODEL=your-model-name
 export OPENAI_API_KEY="not-needed"  # 空でない値が必要な場合
 export OPENAI_API_BASE="http://localhost:1234/v1"
 girb
 ```
 
-### 手動設定
+### 詳細設定
 
-`~/.irbrc` でプロバイダーを手動で設定できます:
+より細かい制御が必要な場合、`~/.irbrc`でGirbを設定できます:
 
 ```ruby
 # ~/.irbrc
 require 'girb-ruby_llm'
 
-RubyLLM.configure do |config|
-  config.ollama_api_base = "http://localhost:11434/v1"
-end
-RubyLLM::Models.refresh!
-
 Girb.configure do |c|
-  c.provider = Girb::Providers::RubyLlm.new(model: 'llama3.2:latest')
+  c.debug = true  # デバッグ出力を有効化
+  c.custom_prompt = <<~PROMPT
+    破壊的操作の前に必ず確認してください。
+  PROMPT
 end
 ```
 
+注: ローカルプロバイダー（Ollama、GPUStack）使用時は`RubyLLM::Models.refresh!`が自動的に呼ばれます。
+
 ## 対応モデル
 
 サポートされているモデルの完全なリストは[RubyLLM Available Models](https://rubyllm.com/reference/available-models)を参照してください。

data/lib/girb-ruby_llm/version.rb

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

data/lib/girb-ruby_llm.rb

@@ -32,6 +32,9 @@ RUBY_LLM_CONFIG_MAP = {
 # Check if any RubyLLM config is available
 has_config = RUBY_LLM_CONFIG_MAP.any? { |env_var, _| ENV[env_var] }
 
+# Local providers that require Models.refresh!
+LOCAL_PROVIDERS = %w[OLLAMA_API_BASE GPUSTACK_API_BASE].freeze
+
 if has_config
   # Configure RubyLLM with all available environment variables
   RubyLLM.configure do |config|
@@ -40,9 +43,18 @@ if has_config
     end
   end
 
+  # Refresh models for local providers (Ollama, GPUStack)
+  if LOCAL_PROVIDERS.any? { |env_var| ENV[env_var] }
+    RubyLLM::Models.refresh!
+  end
+
+  model = ENV["GIRB_MODEL"]
+  unless model
+    warn "[girb-ruby_llm] GIRB_MODEL not set. Please specify a model."
+    warn "[girb-ruby_llm]   Example: export GIRB_MODEL=gemini-2.5-flash"
+  end
+
   Girb.configure do |c|
-    unless c.provider
-      c.provider = Girb::Providers::RubyLlm.new(model: c.model)
-    end
+    c.provider ||= Girb::Providers::RubyLlm.new(model: model)
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: girb-ruby_llm
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - rira100000000