Ruby client for Gemini generateContent. Includes a CLI and a PR review app.

gem install friday_gemini_ai

With Bundler:

gem 'friday_gemini_ai', require: 'vesper'

The package is published as friday_gemini_ai. The runtime entrypoint is vesper.

Set your API key in .env:

GEMINI_API_KEY=your_api_key

require 'vesper'
GeminiAI.load_env

client = GeminiAI::Client.new
puts client.generate_text('Write a haiku about Ruby')

Use a different model when needed:

fast_client = GeminiAI::Client.new(model: :flash)
puts fast_client.generate_text('Explain Ruby in one sentence')

Short aliases: :pro uses gemini-pro-latest, :flash uses gemini-3.5-flash, and :flash_lite uses gemini-3.1-flash-lite. Legacy :pro_2_0 maps to gemini-2.0-flash.

The gem does not wrap embeddings, Imagen, or Veo APIs.

Vesper supports text generation, chat, image input for generateContent, model aliases, safety settings, API key masking, retries, and a local CLI.

Client validation and API failures raise GeminiAI::Error with a readable message. HTTP 429 responses are retried automatically up to three times with exponential backoff.

begin
  response = client.generate_text('Hello')
  puts response
rescue GeminiAI::Error => err
  warn "Generation failed: #{err.message}"
end

Common failures include:

• Missing or invalid GEMINI_API_KEY
• Empty prompts
• Prompts over the configured maximum length
• Gemini API errors returned by the service
• Network errors raised by HTTParty

Rate-limit responses (429) are retried up to three times with waits of 5, 10, and 20 seconds.

Requests use a 30 second HTTParty timeout.

require 'vesper'

GeminiAI::Client.logger.level = Logger::INFO
client = GeminiAI::Client.new

Ruby 3.3 or later. Linux and macOS are tested.

GEMINI_API_KEY=your_api_key_here

./bin/gemini test
./bin/gemini generate "Your prompt"
./bin/gemini chat

bundle exec rake test          # Run tests
bundle exec rake docs          # Build API docs
gem build friday_gemini_ai.gemspec

Vesper Review is the PR review app in this repo. It defaults to gemini-3.5-flash; retrieval context is off unless enabled in vesper/config.yaml.

For setup details, see vesper/Vesper.md.

client = GeminiAI::Client.new
puts client.generate_text('Write a haiku about Ruby')

image_data = Base64.strict_encode64(File.binread('path/to/image.jpg'))
puts client.generate_image_text(image_data, 'Describe this image')

messages = [
  { role: 'user', content: 'Hello!' },
  { role: 'model', content: 'Hi there!' },
  { role: 'user', content: 'Tell me about Ruby.' }
]
puts client.chat(messages, system_instruction: 'Be concise.')

Fork the repo and open a pull request.

MIT → see LICENSE.

Vesper Review