llm_providers 0.2.1 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 660628c05ed3e6beb83cbf9e9e938ef587a8678beaf6f7c9c9b40046d511d863
-  data.tar.gz: cb83106d26fa942f1bae1122969c41a17e298de5cf58966a0b718ae8fc1fc56b
+  metadata.gz: f834a22b64b2340ae461021d17a8dc2d0c65ff22182ea57f750c851686d4c152
+  data.tar.gz: 4c459fb08e001951fcd04343de74ffff1fb025325bf9ffdd90b95cd03ce5a0b8
 SHA512:
-  metadata.gz: c45d5e3e44a900f721c9314d7f62afda073808f24b73abd9dc305f12079f3509f71ac4abe6d895128ed7a26cf8751254989ec272a52f6031b6161c4c8ad61c7b
-  data.tar.gz: 7086766e28a072c3f6a9b47ac7acc48ba237a09f6bea29e3c1a63b287dd4ecbf07b97d8ef380c9c3823fa8a1144eb50ffd5495a59f69efdd0e5ff01ecacffbee
+  metadata.gz: d4fede081164f7cb0eb33b954f81c912d514ae32cc71ff020e16dd6ec0c15f98cd98b3657bdbb92264c9760121f7b7c85a90ae58f840a55aacd65d35d6b48ff2
+  data.tar.gz: 77b512797ec93a5c08c85eb997bbccd769572ea5e1c901c4393acf0078a9ba8c6375a831bb034878a5a637b91fa83a0feb945611cb00e33353cb0561a9db2462

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [0.2.2] - 2026-02-27
+
+### Fixed
+
+- Update READMEs: remove experimental label from OpenRouter, add OpenRouter usage docs (headers, routing, models API, error handling)
+
 ## [0.2.1] - 2026-02-27
 
 ### Fixed

data/README.ja.md

@@ -22,7 +22,7 @@
 | `anthropic` | `ANTHROPIC_API_KEY` | `claude-sonnet-4-5-20250929` |
 | `openai` | `OPENAI_API_KEY` | `gpt-5-mini` |
 | `google` | `GOOGLE_API_KEY` | `gemini-2.5-flash` |
-| `openrouter` *(実験的)* | `OPENROUTER_API_KEY` | `anthropic/claude-sonnet-4.5` |
+| `openrouter` | `OPENROUTER_API_KEY` | `anthropic/claude-sonnet-4.5` |
 
 ## インストール
 
@@ -120,14 +120,32 @@ end
 }
 ```
 
+### OpenRouter
+
+OpenRouter を使えば、単一の API で 300 以上のモデルにアクセスできます。この gem が直接サポートしていないプロバイダー（DeepSeek、Meta Llama、Mistral、Qwen など）に最適です。
+
+```ruby
+provider = LlmProviders::Providers.build(
+  :openrouter,
+  model: "deepseek/deepseek-chat",
+  app_name: "MyApp",
+  app_url: "https://myapp.example.com",
+  provider: { order: ["DeepSeek", "Together"], allow_fallbacks: true }
+)
+
+# 利用可能なモデル一覧
+models = LlmProviders::Providers::Openrouter.models
+models.each { |m| puts "#{m[:id]} (ctx: #{m[:context_length]})" }
+```
+
 ### エラーハンドリング
 
 ```ruby
 begin
   result = provider.chat(messages: messages)
 rescue LlmProviders::ProviderError => e
-  puts "エラー: #{e.message}"
-  puts "コード: #{e.code}"  # 例: "anthropic_error", "openai_error"
+  puts "エラー: #{e.message}"  # OpenRouter: "[DeepSeek] Model is unavailable"
+  puts "コード: #{e.code}"     # 例: "anthropic_error", "openrouter_error"
 end
 ```
 
@@ -146,6 +164,10 @@ ANTHROPIC_API_KEY=your-key ruby examples/with_tools.rb
 # 他のプロバイダー
 OPENAI_API_KEY=your-key ruby examples/simple_chat.rb openai
 GOOGLE_API_KEY=your-key ruby examples/simple_chat.rb google
+
+# OpenRouter (DeepSeek, Llama, Mistral など)
+OPENROUTER_API_KEY=your-key ruby examples/simple_chat.rb openrouter deepseek/deepseek-chat
+OPENROUTER_API_KEY=your-key ruby examples/with_tools.rb openrouter meta-llama/llama-3.3-70b-instruct
 ```
 
 ## ライセンス

data/README.md

@@ -22,7 +22,7 @@ A lightweight, unified interface for multiple LLM providers. Only depends on `fa
 | `anthropic` | `ANTHROPIC_API_KEY` | `claude-sonnet-4-5-20250929` |
 | `openai` | `OPENAI_API_KEY` | `gpt-5-mini` |
 | `google` | `GOOGLE_API_KEY` | `gemini-2.5-flash` |
-| `openrouter` *(experimental)* | `OPENROUTER_API_KEY` | `anthropic/claude-sonnet-4.5` |
+| `openrouter` | `OPENROUTER_API_KEY` | `anthropic/claude-sonnet-4.5` |
 
 ## Installation
 
@@ -120,14 +120,32 @@ Every `chat` call returns a hash with:
 }
 ```
 
+### OpenRouter
+
+OpenRouter gives you access to 300+ models through a single API — ideal for providers not directly supported by this gem (DeepSeek, Meta Llama, Mistral, Qwen, etc.).
+
+```ruby
+provider = LlmProviders::Providers.build(
+  :openrouter,
+  model: "deepseek/deepseek-chat",
+  app_name: "MyApp",
+  app_url: "https://myapp.example.com",
+  provider: { order: ["DeepSeek", "Together"], allow_fallbacks: true }
+)
+
+# List available models
+models = LlmProviders::Providers::Openrouter.models
+models.each { |m| puts "#{m[:id]} (ctx: #{m[:context_length]})" }
+```
+
 ### Error Handling
 
 ```ruby
 begin
   result = provider.chat(messages: messages)
 rescue LlmProviders::ProviderError => e
-  puts "Error: #{e.message}"
-  puts "Code: #{e.code}"  # e.g., "anthropic_error", "openai_error"
+  puts "Error: #{e.message}"  # OpenRouter: "[DeepSeek] Model is unavailable"
+  puts "Code: #{e.code}"      # e.g., "anthropic_error", "openrouter_error"
 end
 ```
 
@@ -146,6 +164,10 @@ ANTHROPIC_API_KEY=your-key ruby examples/with_tools.rb
 # Other providers
 OPENAI_API_KEY=your-key ruby examples/simple_chat.rb openai
 GOOGLE_API_KEY=your-key ruby examples/simple_chat.rb google
+
+# OpenRouter (DeepSeek, Llama, Mistral, etc.)
+OPENROUTER_API_KEY=your-key ruby examples/simple_chat.rb openrouter deepseek/deepseek-chat
+OPENROUTER_API_KEY=your-key ruby examples/with_tools.rb openrouter meta-llama/llama-3.3-70b-instruct
 ```
 
 ## License

data/lib/llm_providers/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module LlmProviders
-  VERSION = "0.2.1"
+  VERSION = "0.2.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: llm_providers
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.2
 platform: ruby
 authors:
 - kaba