feat(Configuration): Add http_proxy configuration option (#189)

implement proxy setup in Connection

---------

Co-authored-by: jeff.dean <jeff.dean@kakaomobility.com>
Co-authored-by: Carmine Paolino <carmine@paolino.me>

Author: 3 people

docs/configuration.md

@@ -78,6 +78,7 @@ RubyLLM.configure do |config|
   config.retry_interval = 0.1 # Initial delay in seconds (default: 0.1)
   config.retry_backoff_factor = 2 # Multiplier for subsequent retries (default: 2)
   config.retry_interval_randomness = 0.5 # Jitter factor (default: 0.5)
+  config.http_proxy = ENV.fetch('HTTP_PROXY', 'http://proxy.example.com:3128') # Optional HTTP proxy
 
   # --- Logging Settings ---
   config.log_file = '/logs/ruby_llm.log'

lib/ruby_llm/configuration.rb

@@ -34,6 +34,7 @@ class Configuration
                   :retry_interval,
                   :retry_backoff_factor,
                   :retry_interval_randomness,
+                  :http_proxy,
                   # Logging configuration
                   :log_file,
                   :log_level
@@ -45,6 +46,7 @@ def initialize
       @retry_interval = 0.1
       @retry_backoff_factor = 2
       @retry_interval_randomness = 0.5
+      @http_proxy = nil
 
       # Default models
       @default_model = 'gpt-4.1-nano'

lib/ruby_llm/connection.rb

@@ -28,6 +28,7 @@ def initialize(provider, config)
         setup_logging(faraday)
         setup_retry(faraday)
         setup_middleware(faraday)
+        setup_http_proxy(faraday)
       end
     end
 
@@ -83,6 +84,12 @@ def setup_middleware(faraday)
       faraday.use :llm_errors, provider: @provider
     end
 
+    def setup_http_proxy(faraday)
+      return unless @config.http_proxy
+
+      faraday.proxy = @config.http_proxy
+    end
+
     def retry_exceptions
       [
         Errno::ETIMEDOUT,