llm_conductor 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 94848876574eca5294236d61d79175b6e28fc918c6bcbd0af969d70fc50cc6c8
-  data.tar.gz: 18865a4228201006c9ebf84e0aac4bd6b946e1c551a121e323eed827477bb3ca
+  metadata.gz: c1b006030ac01906369f830f2c11d958f40c3bf3a48404179d78c6b1e75a82e5
+  data.tar.gz: 7ccf09702230675a381f164f4ccb91034aec880c5769cb8887711c6737385c46
 SHA512:
-  metadata.gz: f16ee4255f54f3daef35a2557cd19fc171dbc238c2525475d95c3209ca5771f07f9ccd7d6e485f6adef979625008c0fb360d5705adea23bd14d987f051b236c0
-  data.tar.gz: 62f464b4dcc76ce676f735db190e9a16ba9bee5f10b4dbdbd4c212badbfb7c8a736465bc40cd8228c11e2e1fed6f7afe823d05dfcd2dfc6c0cb689870e0e4acc
+  metadata.gz: 4c3283602c064e5c7e67ac5a1b26353c936b9d5d351ad21d87a89058aa045af1f8f916f350ac07db4a0405a6fe9091b09ecc00b091afd57039d3ae560bd199e8
+  data.tar.gz: 571400d81fa8029ecf9f9d4a53c48ac26392c13de927994c358b0e953d27257b94ff929f1d65f13b64ccddaada8785e33f271b4cf99ebdad74c63abef3dd4a97

data/README.md

@@ -1,10 +1,10 @@
 # LLM Conductor
 
-A powerful Ruby gem for orchestrating multiple Language Model providers with a unified, modern interface. LLM Conductor provides seamless integration with OpenAI GPT and Ollama with advanced prompt management, data building patterns, and comprehensive response handling.
+A powerful Ruby gem from [Ekohe](https://ekohe.com) for orchestrating multiple Language Model providers with a unified, modern interface. LLM Conductor provides seamless integration with OpenAI GPT, Anthropic Claude, Google Gemini, and Ollama with advanced prompt management, data building patterns, and comprehensive response handling.
 
 ## Features
 
-🚀 **Multi-Provider Support** - OpenAI GPT and Ollama with automatic vendor detection  
+🚀 **Multi-Provider Support** - OpenAI GPT, Anthropic Claude, Google Gemini, and Ollama with automatic vendor detection
 🎯 **Unified Modern API** - Simple `LlmConductor.generate()` interface with rich Response objects  
 📝 **Advanced Prompt Management** - Registrable prompt classes with inheritance and templating  
 🏗️ **Data Builder Pattern** - Structured data preparation for complex LLM inputs  
@@ -57,8 +57,8 @@ response = LlmConductor.generate(
   model: 'gpt-5-mini',
   type: :summarize_description,
   data: {
-    name: 'TechCorp',
-    domain_name: 'techcorp.com', 
+    name: 'Ekohe',
+    domain_name: 'ekohe.com',
     description: 'An AI company specializing in...'
   }
 )
@@ -94,6 +94,14 @@ LlmConductor.configure do |config|
     organization: ENV['OPENAI_ORG_ID'] # Optional
   )
 
+  config.anthropic(
+    api_key: ENV['ANTHROPIC_API_KEY']
+  )
+
+  config.gemini(
+    api_key: ENV['GEMINI_API_KEY']
+  )
+
   config.ollama(
     base_url: ENV['OLLAMA_ADDRESS'] || 'http://localhost:11434'
   )
@@ -106,6 +114,8 @@ The gem automatically detects these environment variables:
 
 - `OPENAI_API_KEY` - OpenAI API key
 - `OPENAI_ORG_ID` - OpenAI organization ID (optional)
+- `ANTHROPIC_API_KEY` - Anthropic API key
+- `GEMINI_API_KEY` - Google Gemini API key
 - `OLLAMA_ADDRESS` - Ollama server address
 
 ## Supported Providers & Models
@@ -118,7 +128,81 @@ response = LlmConductor.generate(
 )
 ```
 
-### Ollama (Default for non-GPT models)
+### Anthropic Claude (Automatic for Claude models)
+```ruby
+response = LlmConductor.generate(
+  model: 'claude-3-5-sonnet-20241022',  # Auto-detects Anthropic
+  prompt: 'Your prompt here'
+)
+
+# Or explicitly specify vendor
+response = LlmConductor.generate(
+  model: 'claude-3-5-sonnet-20241022',
+  vendor: :anthropic,
+  prompt: 'Your prompt here'
+)
+```
+
+**Supported Claude Models:**
+- `claude-3-5-sonnet-20241022` (Latest Claude 3.5 Sonnet)
+- `claude-3-5-haiku-20241022` (Claude 3.5 Haiku)
+- `claude-3-opus-20240229` (Claude 3 Opus)
+- `claude-3-sonnet-20240229` (Claude 3 Sonnet)
+- `claude-3-haiku-20240307` (Claude 3 Haiku)
+
+**Why Choose Claude?**
+- **Superior Reasoning**: Excellent for complex analysis and problem-solving
+- **Code Generation**: Outstanding performance for programming tasks
+- **Long Context**: Support for large documents and conversations
+- **Safety**: Built with safety and helpfulness in mind
+- **Cost Effective**: Competitive pricing for high-quality outputs
+
+### Google Gemini (Automatic for Gemini models)
+```ruby
+response = LlmConductor.generate(
+  model: 'gemini-2.5-flash',  # Auto-detects Gemini
+  prompt: 'Your prompt here'
+)
+
+# Or explicitly specify vendor
+response = LlmConductor.generate(
+  model: 'gemini-2.5-flash',
+  vendor: :gemini,
+  prompt: 'Your prompt here'
+)
+```
+
+**Supported Gemini Models:**
+- `gemini-2.5-flash` (Latest Gemini 2.5 Flash)
+- `gemini-2.5-flash` (Gemini 2.5 Flash)
+- `gemini-2.0-flash` (Gemini 2.0 Flash)
+
+**Why Choose Gemini?**
+- **Multimodal**: Native support for text, images, and other modalities
+- **Long Context**: Massive context windows for large documents
+- **Fast Performance**: Optimized for speed and efficiency
+- **Google Integration**: Seamless integration with Google services
+- **Competitive Pricing**: Cost-effective for high-volume usage
+
+### Ollama (Default for non-GPT/Claude/Gemini models)
+```ruby
+response = LlmConductor.generate(
+  model: 'llama3.2',  # Auto-detects Ollama for non-GPT/Claude/Gemini models
+  prompt: 'Your prompt here'
+)
+```
+
+### Vendor Detection
+
+The gem automatically detects the appropriate provider based on model names:
+
+- **OpenAI**: Models starting with `gpt-` (e.g., `gpt-4`, `gpt-3.5-turbo`)
+- **Anthropic**: Models starting with `claude-` (e.g., `claude-3-5-sonnet-20241022`)
+- **Google Gemini**: Models starting with `gemini-` (e.g., `gemini-2.5-flash`, `gemini-2.0-flash`)
+- **Ollama**: All other models (e.g., `llama3.2`, `mistral`, `codellama`)
+
+You can also explicitly specify the vendor:
+
 ```ruby
 response = LlmConductor.generate(
   model: 'llama3.2',  # Auto-detects Ollama for non-GPT models
@@ -159,8 +243,8 @@ response = LlmConductor.generate(
   model: 'gpt-5-mini',
   type: :detailed_analysis,
   data: {
-    name: 'TechCorp',
-    domain_name: 'techcorp.com',
+    name: 'Ekohe',
+    domain_name: 'ekohe.com',
     description: 'A leading AI company...'
   }
 )
@@ -385,7 +469,7 @@ bin/console
 
 ## Testing
 
-The gem includes comprehensive test coverage with unit, integration, and performance tests. See `spec/TESTING_GUIDE.md` for detailed testing information.
+The gem includes comprehensive test coverage with unit, integration, and performance tests.
 
 ## Performance
 
@@ -407,7 +491,3 @@ Bug reports and pull requests are welcome on GitHub at https://github.com/ekohe/
 ## License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
-
-## Code of Conduct
-
-This project is intended to be a safe, welcoming space for collaboration. Contributors are expected to adhere to the [code of conduct](https://github.com/ekohe/llm_conductor/blob/main/CODE_OF_CONDUCT.md).

data/examples/gemini_usage.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+require_relative '../lib/llm_conductor'
+
+# Configure Gemini API key
+LlmConductor.configure do |config|
+  config.gemini_api_key = ENV['GEMINI_API_KEY'] || 'your_gemini_api_key_here'
+end
+
+# Example usage
+response = LlmConductor.generate(
+  model: 'gemini-2.5-flash',
+  prompt: 'Explain how AI works in a few words'
+)
+
+puts "Model: #{response.model}"
+puts "Output: #{response.output}"
+puts "Vendor: #{response.metadata[:vendor]}"

data/lib/llm_conductor/client_factory.rb

@@ -5,26 +5,37 @@ module LlmConductor
   class ClientFactory
     def self.build(model:, type:, vendor: nil)
       vendor ||= determine_vendor(model)
+      client_class = client_class_for_vendor(vendor)
+      client_class.new(model:, type:)
+    end
 
-      client_class = case vendor
-                     when :openai, :gpt
-                       Clients::GptClient
-                     when :openrouter
-                       Clients::OpenrouterClient
-                     when :ollama
-                       Clients::OllamaClient
-                     else
-                       raise ArgumentError,
-                             "Unsupported vendor: #{vendor}. Supported vendors: openai, openrouter, ollama"
-                     end
+    def self.client_class_for_vendor(vendor)
+      client_classes = {
+        anthropic: Clients::AnthropicClient,
+        claude: Clients::AnthropicClient,
+        openai: Clients::GptClient,
+        gpt: Clients::GptClient,
+        openrouter: Clients::OpenrouterClient,
+        ollama: Clients::OllamaClient,
+        gemini: Clients::GeminiClient,
+        google: Clients::GeminiClient
+      }
 
-      client_class.new(model:, type:)
+      client_classes[vendor] || raise(
+        ArgumentError,
+        "Unsupported vendor: #{vendor}. " \
+        'Supported vendors: anthropic, openai, openrouter, ollama, gemini'
+      )
     end
 
     def self.determine_vendor(model)
       case model
+      when /^claude/i
+        :anthropic
       when /^gpt/i
         :openai
+      when /^gemini/i
+        :gemini
       else
         :ollama # Default to Ollama for non-specific model names
       end

data/lib/llm_conductor/clients/anthropic_client.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require 'anthropic'
+
+module LlmConductor
+  module Clients
+    # Anthropic Claude client implementation for accessing Claude models via Anthropic API
+    class AnthropicClient < BaseClient
+      private
+
+      def generate_content(prompt)
+        response = client.messages.create(
+          model:,
+          max_tokens: 4096,
+          messages: [{ role: 'user', content: prompt }]
+        )
+
+        response.content.first.text
+      rescue Anthropic::Errors::APIError => e
+        raise StandardError, "Anthropic API error: #{e.message}"
+      end
+
+      def client
+        @client ||= begin
+          config = LlmConductor.configuration.provider_config(:anthropic)
+          Anthropic::Client.new(api_key: config[:api_key])
+        end
+      end
+    end
+  end
+end

data/lib/llm_conductor/clients/base_client.rb

@@ -90,7 +90,7 @@ module LlmConductor
       def build_metadata
         {
           vendor: self.class.name.split('::').last.gsub('Client', '').downcase.to_sym,
-          timestamp: Time.zone.now.iso8601
+          timestamp: Time.now.utc.iso8601
         }
       end
     end

data/lib/llm_conductor/clients/gemini_client.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require 'gemini-ai'
+
+module LlmConductor
+  module Clients
+    # Google Gemini client implementation for accessing Gemini models via Google AI API
+    class GeminiClient < BaseClient
+      private
+
+      def generate_content(prompt)
+        payload = {
+          contents: [
+            { parts: [{ text: prompt }] }
+          ]
+        }
+
+        response = client.generate_content(payload)
+        response.dig('candidates', 0, 'content', 'parts', 0, 'text')
+      end
+
+      def client
+        @client ||= begin
+          config = LlmConductor.configuration.provider_config(:gemini)
+          Gemini.new(
+            credentials: {
+              service: 'generative-language-api',
+              api_key: config[:api_key]
+            },
+            options: { model: }
+          )
+        end
+      end
+    end
+  end
+end

data/lib/llm_conductor/configuration.rb

@@ -22,6 +22,14 @@ module LlmConductor
       setup_defaults_from_env
     end
 
+    # Configure Anthropic provider
+    def anthropic(api_key: nil, **options)
+      @providers[:anthropic] = {
+        api_key: api_key || ENV['ANTHROPIC_API_KEY'],
+        **options
+      }
+    end
+
     # Configure OpenAI provider
     def openai(api_key: nil, organization: nil, **options)
       @providers[:openai] = {
@@ -47,12 +55,28 @@ module LlmConductor
       }
     end
 
+    # Configure Google Gemini provider
+    def gemini(api_key: nil, **options)
+      @providers[:gemini] = {
+        api_key: api_key || ENV['GEMINI_API_KEY'],
+        **options
+      }
+    end
+
     # Get provider configuration
     def provider_config(provider)
       @providers[provider.to_sym] || {}
     end
 
     # Legacy compatibility methods
+    def anthropic_api_key
+      provider_config(:anthropic)[:api_key]
+    end
+
+    def anthropic_api_key=(value)
+      anthropic(api_key: value)
+    end
+
     def openai_api_key
       provider_config(:openai)[:api_key]
     end
@@ -77,12 +101,22 @@ module LlmConductor
       ollama(base_url: value)
     end
 
+    def gemini_api_key
+      provider_config(:gemini)[:api_key]
+    end
+
+    def gemini_api_key=(value)
+      gemini(api_key: value)
+    end
+
     private
 
     def setup_defaults_from_env
       # Auto-configure providers if environment variables are present
+      anthropic if ENV['ANTHROPIC_API_KEY']
       openai if ENV['OPENAI_API_KEY']
       openrouter if ENV['OPENROUTER_API_KEY']
+      gemini if ENV['GEMINI_API_KEY']
       ollama # Always configure Ollama with default URL
     end
   end

data/lib/llm_conductor/version.rb

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

data/lib/llm_conductor.rb

@@ -8,14 +8,16 @@ require_relative 'llm_conductor/prompts'
 require_relative 'llm_conductor/prompts/base_prompt'
 require_relative 'llm_conductor/prompt_manager'
 require_relative 'llm_conductor/clients/base_client'
+require_relative 'llm_conductor/clients/anthropic_client'
 require_relative 'llm_conductor/clients/gpt_client'
 require_relative 'llm_conductor/clients/ollama_client'
 require_relative 'llm_conductor/clients/openrouter_client'
+require_relative 'llm_conductor/clients/gemini_client'
 require_relative 'llm_conductor/client_factory'
 
 # LLM Conductor provides a unified interface for multiple Language Model providers
-# including OpenAI GPT, OpenRouter, and Ollama with built-in prompt templates,
-# token counting, and extensible client architecture.
+# including OpenAI GPT, Anthropic Claude, Google Gemini, OpenRouter, and Ollama
+# with built-in prompt templates, token counting, and extensible client architecture.
 module LlmConductor
   class Error < StandardError; end
 
@@ -54,17 +56,21 @@ module LlmConductor
 
     def client_class_for_vendor(vendor)
       case vendor
+      when :anthropic, :claude then Clients::AnthropicClient
       when :openai, :gpt then Clients::GptClient
       when :openrouter then Clients::OpenrouterClient
       when :ollama then Clients::OllamaClient
+      when :gemini, :google then Clients::GeminiClient
       else
-        raise ArgumentError, "Unsupported vendor: #{vendor}. Supported vendors: openai, openrouter, ollama"
+        raise ArgumentError,
+              "Unsupported vendor: #{vendor}. " \
+              'Supported vendors: anthropic, openai, openrouter, ollama, gemini'
       end
     end
   end
 
   # List of supported vendors
-  SUPPORTED_VENDORS = %i[openai openrouter ollama].freeze
+  SUPPORTED_VENDORS = %i[anthropic openai openrouter ollama gemini].freeze
 
   # List of supported prompt types
   SUPPORTED_PROMPT_TYPES = %i[

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: llm_conductor
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Ben Zheng
 bindir: exe
 cert_chain: []
-date: 2025-09-19 00:00:00.000000000 Z
+date: 2025-09-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -23,6 +23,34 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: anthropic
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: gemini-ai
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.3'
 - !ruby/object:Gem::Dependency
   name: ollama-ai
   requirement: !ruby/object:Gem::Requirement
@@ -111,12 +139,15 @@ files:
 - Rakefile
 - config/initializers/llm_conductor.rb
 - examples/data_builder_usage.rb
+- examples/gemini_usage.rb
 - examples/prompt_registration.rb
 - examples/rag_usage.rb
 - examples/simple_usage.rb
 - lib/llm_conductor.rb
 - lib/llm_conductor/client_factory.rb
+- lib/llm_conductor/clients/anthropic_client.rb
 - lib/llm_conductor/clients/base_client.rb
+- lib/llm_conductor/clients/gemini_client.rb
 - lib/llm_conductor/clients/gpt_client.rb
 - lib/llm_conductor/clients/ollama_client.rb
 - lib/llm_conductor/clients/openrouter_client.rb