geminize 0.1.0 → 1.0.0

data/examples/multimodal.rb

@@ -8,7 +8,8 @@ Geminize.configure do |config|
   config.api_key = ENV["GEMINI_API_KEY"] || "your-api-key-here"
 
   # Specify the model to use (optional)
-  config.default_model = "gemini-2.0-flash" # This model supports multimodal inputs
+  # Use a model that supports multimodal input, like gemini-1.5-flash-latest
+  config.default_model = "gemini-1.5-flash-latest"
 end
 
 puts "============================================================"
@@ -19,7 +20,7 @@ begin
   # Generate content with an image from a file
   response = Geminize.generate_text_multimodal(
     "Describe this image in detail:",
-    [{source_type: "file", data: "path/to/image.jpg"}]
+    [{source_type: "file", data: File.join(File.dirname(__FILE__), "ruby.png")}] # Use relative path from script
   )
 
   puts "Response:"
@@ -27,7 +28,7 @@ begin
   puts "\nFinish reason: #{response.finish_reason}"
 rescue => e
   puts "Error: #{e.message}"
-  puts "Make sure to update the image path to a real image on your system."
+  puts "Make sure the path './ruby.png' is correct relative to the project root."
 end
 
 puts "\n============================================================"
@@ -38,7 +39,7 @@ begin
   # Generate content with an image from a URL
   response = Geminize.generate_text_multimodal(
     "What's in this image?",
-    [{source_type: "url", data: "https://example.com/sample-image.jpg"}],
+    [{source_type: "url", data: "https://miro.medium.com/v2/resize:fit:720/format:webp/1*zkA1cWgJDlMUxI5TRcIHdQ.jpeg"}], # Updated URL
     nil, # Use default model
     temperature: 0.7
   )
@@ -47,7 +48,7 @@ begin
   puts response.text
 rescue => e
   puts "Error: #{e.message}"
-  puts "Make sure to use a valid image URL."
+  puts "Make sure the URL is valid and accessible."
 end
 
 puts "\n============================================================"
@@ -55,12 +56,12 @@ puts "Example 3: Multiple images comparison"
 puts "============================================================"
 
 begin
-  # Generate content comparing multiple images
+  # Generate content comparing multiple images (using the same image twice here for simplicity)
   response = Geminize.generate_text_multimodal(
-    "Compare these two images and describe the differences:",
+    "Compare these two images and describe the differences (they might be the same):",
     [
-      {source_type: "file", data: "path/to/image1.jpg"},
-      {source_type: "file", data: "path/to/image2.jpg"}
+      {source_type: "file", data: File.join(File.dirname(__FILE__), "ruby.png")}, # Use relative path from script
+      {source_type: "file", data: File.join(File.dirname(__FILE__), "ruby.png")}  # Use relative path from script
     ],
     "gemini-1.5-pro-latest", # Explicitly specify model
     max_tokens: 500
@@ -70,7 +71,7 @@ begin
   puts response.text
 rescue => e
   puts "Error: #{e.message}"
-  puts "Make sure to update the image paths to real images on your system."
+  puts "Make sure the path './ruby.png' is correct."
 end
 
 puts "\n============================================================"
@@ -79,19 +80,19 @@ puts "============================================================"
 
 begin
   # Read image directly into bytes
-  image_bytes = File.binread("path/to/image.jpg")
+  image_bytes = File.binread(File.join(File.dirname(__FILE__), "ruby.png")) # Use relative path from script
 
   # Generate content with raw image bytes
   response = Geminize.generate_text_multimodal(
     "Analyze this image:",
-    [{source_type: "bytes", data: image_bytes, mime_type: "image/jpeg"}]
+    [{source_type: "bytes", data: image_bytes, mime_type: "image/png"}] # Updated MIME type
   )
 
   puts "Response for raw bytes input:"
   puts response.text
 rescue => e
   puts "Error: #{e.message}"
-  puts "Make sure to update the image path to a real image on your system."
+  puts "Make sure the path './ruby.png' is correct."
 end
 
 puts "\n============================================================"
@@ -111,16 +112,22 @@ begin
   )
 
   # Add multiple images using different methods
-  request.add_image_from_file("path/to/image1.jpg")
-  request.add_image_from_url("https://example.com/image2.jpg")
+  request.add_image_from_file(File.join(File.dirname(__FILE__), "ruby.png")) # Use relative path from script
+  request.add_image_from_url("https://miro.medium.com/v2/resize:fit:720/format:webp/1*zkA1cWgJDlMUxI5TRcIHdQ.jpeg") # Updated URL
 
   # Generate the response
   response = generator.generate(request)
 
   puts "Response using ContentRequest directly:"
   puts response.text
-  puts "\nUsed #{response.usage.total_tokens} tokens total"
+
+  # Check if usage data is available before accessing it
+  if response.usage&.total_tokens
+    puts "\nUsed #{response.usage.total_tokens} tokens total"
+  else
+    puts "\nUsage data not available in the response."
+  end
 rescue => e
   puts "Error: #{e.message}"
-  puts "Make sure to update the paths to real images."
+  puts "Make sure paths and URLs are valid."
 end

data/lib/geminize/models/content_request.rb

@@ -211,30 +211,31 @@ module Geminize
       # Convert the request to a hash suitable for the API
       # @return [Hash] The request as a hash
       def to_hash
-        request = if multimodal?
-          {
-            contents: [
-              {
-                parts: @content_parts
-              }
-            ],
-            generationConfig: generation_config
-          }.compact
-        else
-          # Keep backward compatibility for text-only requests
-          {
-            contents: [
-              {
-                parts: [
-                  {
-                    text: @prompt
-                  }
-                ]
+        # Map content_parts to the structure the API expects
+        api_parts = @content_parts.map do |part|
+          if part[:type] == "text"
+            {text: part[:text]}
+          elsif part[:type] == "image"
+            {
+              inlineData: {
+                mimeType: part[:mime_type],
+                data: part[:data]
               }
-            ],
-            generationConfig: generation_config
-          }.compact
-        end
+            }
+          else
+            # Handle potential future types or raise error
+            nil # Or raise an error for unknown part types
+          end
+        end.compact # Remove any nil parts from unknown types
+
+        request = {
+          contents: [
+            {
+              parts: api_parts # Use the correctly formatted parts
+            }
+          ],
+          generationConfig: generation_config
+        }.compact
 
         # Add system_instruction if provided
         if @system_instruction

data/lib/geminize/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Geminize
-  VERSION = "0.1.0"
+  VERSION = "1.0.0"
 end

data/lib/geminize.rb

@@ -37,9 +37,6 @@ require_relative "geminize/conversation_repository"
 require_relative "geminize/conversation_service"
 require_relative "geminize/model_info"
 
-# Conditionally load Rails integration if Rails is defined
-require_relative "geminize/rails" if defined?(::Rails)
-
 # Main module for the Geminize gem
 module Geminize
   class Error < StandardError; end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: geminize
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 1.0.0
 platform: ruby
 authors:
 - Nhat Long Nguyen
 bindir: exe
 cert_chain: []
-date: 2025-05-01 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -123,8 +123,7 @@ dependencies:
         version: '2.8'
 description: A convenient and robust Ruby interface for the Google Gemini API, enabling
   easy integration of powerful generative AI models into your applications. Includes
-  support for text generation, chat conversations, embeddings, multimodal content,
-  and Rails integration.
+  support for text generation, chat conversations, embeddings, multimodal content.
 email:
 - nhatlongnguyen1992@gmail.com
 executables: []
@@ -144,11 +143,7 @@ files:
 - examples/configuration.rb
 - examples/embeddings.rb
 - examples/multimodal.rb
-- examples/rails_chat/README.md
-- examples/rails_chat/app/controllers/chat_controller.rb
-- examples/rails_chat/app/views/chat/index.html.erb
-- examples/rails_chat/config/routes.rb
-- examples/rails_initializer.rb
+- examples/ruby.png
 - examples/system_instructions.rb
 - lib/geminize.rb
 - lib/geminize/chat.rb
@@ -174,21 +169,11 @@ files:
 - lib/geminize/models/model.rb
 - lib/geminize/models/model_list.rb
 - lib/geminize/models/stream_response.rb
-- lib/geminize/rails.rb
-- lib/geminize/rails/app/controllers/concerns/geminize/controller.rb
-- lib/geminize/rails/app/helpers/geminize_helper.rb
-- lib/geminize/rails/controller_additions.rb
-- lib/geminize/rails/engine.rb
-- lib/geminize/rails/helper_additions.rb
-- lib/geminize/railtie.rb
 - lib/geminize/request_builder.rb
 - lib/geminize/text_generation.rb
 - lib/geminize/validators.rb
 - lib/geminize/vector_utils.rb
 - lib/geminize/version.rb
-- lib/generators/geminize/install_generator.rb
-- lib/generators/geminize/templates/README
-- lib/generators/geminize/templates/initializer.rb
 - sig/geminize.rbs
 homepage: https://github.com/nhlongnguyen/geminize
 licenses:
@@ -212,7 +197,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 3.6.8
 specification_version: 4
 summary: Ruby interface for Google's Gemini AI API
 test_files: []

data/examples/rails_chat/README.md

@@ -1,69 +0,0 @@
-# Rails Chat Example
-
-This is a basic example of how to implement a chat application with the Geminize gem in a Rails application.
-
-## Features
-
-- Chat interface with Google's Gemini AI
-- Conversation memory between requests using Rails session
-- Support for Turbo and JSON responses
-- Reset conversation functionality
-
-## Implementation
-
-This example demonstrates:
-
-1. How to include Geminize controller concerns
-2. How to use Geminize view helpers
-3. How to maintain conversation state in a Rails application
-
-## File Structure
-
-- `app/controllers/chat_controller.rb` - Controller with Geminize integration
-- `app/views/chat/index.html.erb` - Chat interface view
-- `config/routes.rb` - Routes configuration
-
-## Setup in Your Application
-
-1. Add Geminize to your Gemfile:
-
-```ruby
-gem 'geminize'
-```
-
-2. Run the installer:
-
-```bash
-rails generate geminize:install
-```
-
-3. Configure your API key in `config/initializers/geminize.rb`
-
-4. Include the Geminize helpers in your `ApplicationHelper`
-
-```ruby
-module ApplicationHelper
-  geminize_helper
-end
-```
-
-5. Create your controller with Geminize support
-
-```ruby
-class YourChatController < ApplicationController
-  geminize_controller
-
-  # ... your controller actions
-end
-```
-
-6. Use the helper methods in your views
-
-```erb
-<%= render_gemini_conversation %>
-<%= gemini_chat_form %>
-```
-
-## Styling
-
-This example includes basic CSS to style the chat interface. Feel free to customize it to match your application's design.

data/examples/rails_chat/app/controllers/chat_controller.rb

@@ -1,26 +0,0 @@
-# frozen_string_literal: true
-
-class ChatController < ApplicationController
-  # Include Geminize controller functionality
-  geminize_controller
-
-  def index
-    # Reset conversation if requested
-    reset_gemini_conversation("Chat with Gemini") if params[:reset]
-  end
-
-  def create
-    @response = send_gemini_message(params[:message])
-
-    respond_to do |format|
-      format.html { redirect_to chat_path }
-      format.turbo_stream
-      format.json { render json: {message: @response.text} }
-    end
-  end
-
-  def reset
-    reset_gemini_conversation("New Chat Session")
-    redirect_to chat_path, notice: "Started a new conversation"
-  end
-end

data/examples/rails_chat/app/views/chat/index.html.erb

@@ -1,112 +0,0 @@
-<%# Chat index view %>
-<div class="chat-container">
-  <div class="chat-header">
-    <h1>Chat with Gemini</h1>
-    <%= link_to "Start New Chat", reset_chat_path, class: "new-chat-button", data: { turbo_method: :post } %>
-  </div>
-
-  <div class="conversation-container">
-    <div class="conversation">
-      <%= render_gemini_conversation(nil, include_timestamps: true) %>
-    </div>
-  </div>
-
-  <div class="chat-form-container">
-    <%= gemini_chat_form(
-      placeholder: "Ask me anything...",
-      submit_text: "Send",
-      form_class: "chat-form",
-      input_class: "chat-input",
-      submit_class: "chat-submit"
-    ) %>
-  </div>
-</div>
-
-<% content_for :styles do %>
-<style>
-  .chat-container {
-    max-width: 800px;
-    margin: 0 auto;
-    padding: 20px;
-    font-family: system-ui, -apple-system, sans-serif;
-  }
-
-  .chat-header {
-    display: flex;
-    justify-content: space-between;
-    align-items: center;
-    margin-bottom: 20px;
-  }
-
-  .new-chat-button {
-    background: #6200ee;
-    color: white;
-    padding: 8px 16px;
-    border-radius: 4px;
-    text-decoration: none;
-  }
-
-  .conversation-container {
-    height: 400px;
-    overflow-y: auto;
-    border: 1px solid #e0e0e0;
-    border-radius: 8px;
-    margin-bottom: 20px;
-    padding: 16px;
-    background: #f8f9fa;
-  }
-
-  .gemini-message {
-    margin-bottom: 16px;
-    padding: 12px;
-    border-radius: 8px;
-  }
-
-  .gemini-user-message {
-    background: #e3f2fd;
-    margin-left: 20px;
-  }
-
-  .gemini-ai-message {
-    background: #f1f3f4;
-    margin-right: 20px;
-  }
-
-  .gemini-message-role {
-    font-weight: bold;
-    margin-bottom: 8px;
-  }
-
-  .gemini-message-timestamp {
-    font-size: 0.8em;
-    color: #666;
-    margin-top: 8px;
-    text-align: right;
-  }
-
-  .chat-form {
-    display: flex;
-    gap: 8px;
-  }
-
-  .chat-input {
-    flex: 1;
-    padding: 12px;
-    border: 1px solid #e0e0e0;
-    border-radius: 4px;
-    font-family: inherit;
-    resize: none;
-    height: 80px;
-  }
-
-  .chat-submit {
-    background: #6200ee;
-    color: white;
-    border: none;
-    padding: 12px 24px;
-    border-radius: 4px;
-    cursor: pointer;
-    align-self: flex-end;
-  }
-</style>
-<% end %>

data/examples/rails_chat/config/routes.rb

@@ -1,8 +0,0 @@
-# frozen_string_literal: true
-
-Rails.application.routes.draw do
-  # Chat routes
-  get "chat", to: "chat#index"
-  post "chat", to: "chat#create"
-  post "chat/reset", to: "chat#reset", as: :reset_chat
-end

data/examples/rails_initializer.rb

@@ -1,46 +0,0 @@
-# frozen_string_literal: true
-
-# config/initializers/geminize.rb
-
-# This is an example of how to configure the Geminize gem in a Rails application.
-# Place this file in your config/initializers directory.
-
-# Configure the Geminize gem with your API key and any other settings
-Geminize.configure do |config|
-  # Required settings
-
-  # Get the API key from environment variables (recommended approach)
-  # config.api_key = ENV["GEMINI_API_KEY"]
-
-  # Or set it directly (not recommended for production)
-  config.api_key = "your-api-key-here"
-
-  # Optional settings with defaults
-
-  # API version to use
-  config.api_version = "v1beta"
-
-  # Default model to use when not specified in requests
-  config.default_model = "gemini-1.5-pro-latest"
-
-  # Request timeout in seconds
-  config.timeout = 30
-
-  # Connection open timeout in seconds
-  config.open_timeout = 10
-
-  # Enable request logging for development/debugging
-  # In production, keep this false unless debugging an issue
-  config.log_requests = Rails.env.development?
-end
-
-# Optionally validate the configuration during app initialization
-# This will raise Geminize::ConfigurationError if the configuration is invalid
-begin
-  Geminize.validate_configuration!
-  Rails.logger.info "Geminize configured successfully"
-rescue Geminize::ConfigurationError => e
-  Rails.logger.error "Geminize configuration error: #{e.message}"
-  # You might want to raise the error in development but not in production
-  raise e if Rails.env.development?
-end

data/lib/geminize/rails/app/controllers/concerns/geminize/controller.rb

@@ -1,105 +0,0 @@
-# frozen_string_literal: true
-
-module Geminize
-  # Controller concern for including Gemini functionality in Rails controllers
-  module Controller
-    extend ActiveSupport::Concern
-
-    included do
-      # Helper methods for controllers using Geminize
-      helper_method :current_gemini_conversation if respond_to?(:helper_method)
-    end
-
-    # Current conversation for this controller context
-    # Uses session to maintain conversation state between requests
-    # @return [Geminize::Models::Conversation]
-    def current_gemini_conversation
-      return @current_gemini_conversation if defined?(@current_gemini_conversation)
-
-      if session[:gemini_conversation_id]
-        # Try to load existing conversation
-        begin
-          @current_gemini_conversation = Geminize.load_conversation(session[:gemini_conversation_id])
-        rescue => e
-          Rails.logger.error("Failed to load Gemini conversation: #{e.message}")
-          # Create a new conversation if loading fails
-          create_new_gemini_conversation
-        end
-      else
-        # Create a new conversation if one doesn't exist
-        create_new_gemini_conversation
-      end
-
-      @current_gemini_conversation
-    end
-
-    # Send a message in the current conversation
-    # @param message [String] The message to send
-    # @param model_name [String, nil] Optional model name override
-    # @param params [Hash] Additional parameters for the message
-    # @return [Geminize::Models::ChatResponse] The response
-    def send_gemini_message(message, model_name = nil, params = {})
-      response = Geminize.chat(message, current_gemini_conversation, model_name, params)
-      Geminize.save_conversation(current_gemini_conversation)
-      response
-    end
-
-    # Generate text using Gemini
-    # @param prompt [String] The prompt to send
-    # @param model_name [String, nil] Optional model name override
-    # @param params [Hash] Additional parameters for generation
-    # @return [Geminize::Models::ContentResponse] The response
-    def generate_gemini_text(prompt, model_name = nil, params = {})
-      Geminize.generate_text(prompt, model_name, params)
-    end
-
-    # Generate text with images using Gemini
-    # @param prompt [String] The prompt to send
-    # @param images [Array<Hash>] Array of image data
-    # @param model_name [String, nil] Optional model name override
-    # @param params [Hash] Additional parameters for generation
-    # @return [Geminize::Models::ContentResponse] The response
-    def generate_gemini_multimodal(prompt, images, model_name = nil, params = {})
-      Geminize.generate_text_multimodal(prompt, images, model_name, params)
-    end
-
-    # Generate embeddings for text using Gemini
-    # @param text [String, Array<String>] The text to embed
-    # @param model_name [String, nil] Optional model name override
-    # @param params [Hash] Additional parameters for embedding
-    # @return [Geminize::Models::EmbeddingResponse] The embedding response
-    def generate_gemini_embedding(text, model_name = nil, params = {})
-      Geminize.generate_embedding(text, model_name, params)
-    end
-
-    # Start a new conversation and store its ID in the session
-    # @param title [String, nil] Optional title for the conversation
-    # @param system_instruction [String, nil] Optional system instruction to guide model behavior
-    # @return [Geminize::Models::Conversation] The new conversation
-    def reset_gemini_conversation(title = nil, system_instruction = nil)
-      create_new_gemini_conversation(title, system_instruction)
-    end
-
-    # Set the system instruction for the current conversation
-    # @param system_instruction [String] The system instruction to set
-    # @return [Geminize::Models::Conversation] The updated conversation
-    def set_gemini_system_instruction(system_instruction)
-      current_gemini_conversation.system_instruction = system_instruction
-      Geminize.save_conversation(current_gemini_conversation)
-      current_gemini_conversation
-    end
-
-    private
-
-    # Create a new conversation and store its ID in the session
-    # @param title [String, nil] Optional title for the conversation
-    # @param system_instruction [String, nil] Optional system instruction to guide model behavior
-    # @return [Geminize::Models::Conversation] The new conversation
-    def create_new_gemini_conversation(title = nil, system_instruction = nil)
-      @current_gemini_conversation = Geminize.create_chat(title, system_instruction)
-      session[:gemini_conversation_id] = @current_gemini_conversation.id
-      Geminize.save_conversation(@current_gemini_conversation)
-      @current_gemini_conversation
-    end
-  end
-end