bin/console --debug + explained in README

README.md

@@ -329,6 +329,29 @@ end
 @client.chat("Hello, world!", max_tokens: 512, temperature: 0.5)
 ```
 
+### Debugging API calls
+
+The underlying HTTP library being used is faraday, and you can enabled debugging, or configure other faraday internals by passing a block to the `Groq::Client.new` constructor.
+
+```ruby
+require 'logger'
+
+# Create a logger instance
+logger = Logger.new(STDOUT)
+logger.level = Logger::DEBUG
+
+@client = Groq::Client.new do |faraday|
+  # Log request and response bodies
+  faraday.response :logger, logger, bodies: true
+end
+```
+
+If you pass `--debug` to `bin/console` you will have this logger setup for you.
+
+```plain
+bin/console --debug
+```
+
 ## Examples
 
 ### Pizzeria agent

bin/console

@@ -3,10 +3,36 @@
 
 require "bundler/setup"
 require "groq"
+require "logger"
+require "optparse"
+
+@options = {
+  debug: false
+}
+
+OptionParser.new do |opts|
+  opts.banner = "Usage: bin/console [--debug]"
+
+  opts.on("--debug", "Enable debug mode") do
+    @options[:debug] = true
+  end
+end.parse!
+
+def debug?
+  @options[:debug]
+end
+
+@client = Groq::Client.new do |faraday|
+  if debug?
+    # Create a logger instance
+    logger = Logger.new(STDOUT)
+    logger.level = Logger::DEBUG
+
+    # Log request and response bodies
+    faraday.response :logger, logger, bodies: true
+  end
+end
 
-# You can add fixtures and/or initialization code here to make experimenting
-# with your gem easier. You can also use a different console, if you like.
-@client = Groq::Client.new
 include Groq::Helpers
 
 require "dry-schema"

lib/groq/client.rb

@@ -68,10 +68,15 @@ def post(path:, body:)
   end
 
   def client
-    @client ||= Faraday.new(url: @api_url) do |f|
-      f.request :json # automatically encode the request body as JSON
-      f.response :json # automatically decode JSON responses
-      f.adapter Faraday.default_adapter
+    @client ||= begin
+      connection = Faraday.new(url: @api_url) do |f|
+        f.request :json # automatically encode the request body as JSON
+        f.response :json # automatically decode JSON responses
+        f.adapter Faraday.default_adapter
+      end
+      @faraday_middleware&.call(connection)
+
+      connection
     end
   end
 end