gemini-ai 1.0.0 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0504f65df629365e53197cbf3710261a01a5a6bd0bdc72d7ed86ae8435d97c92
-  data.tar.gz: f5bb325cc4eb668a8d2b0d6e8c4b76b0a3ae88dbc97ba76d329cbdc45a73a93a
+  metadata.gz: 3c6743cedf074b42aed890203de2d5db7697b6302c349c66bae9ac538bf2c680
+  data.tar.gz: ad0c8dd1ba69f58c0e37ed170bbd758231adea02245a63eb10fffa9a57fa2400
 SHA512:
-  metadata.gz: 1d2f70d87440b5e6a4cad3f29a961ab53a708c2e5519c600b7dfe6a7335291571bd69b320057bcd4d2dd32e2f60f48fd5a85e55e6e6ece0334b05517fb57415c
-  data.tar.gz: 004bddaf41f4a3e7a04f496ca31847f44193dd0b12d2446d92a1176241d29ee4d5a20ee7f0b246945f8f1f5277e8032136fc4f4d607042e5c748c0bcec339a0d
+  metadata.gz: 558e2a13c12931f6bfbde1d625cb38b7779e08d8eb5bc0a845861902f50fbcbc43b64c67348220f35316b4a37504daa220c334b0479fb5493973bc49ab34e77c
+  data.tar.gz: 2df9f463de540a3d76f86252bd178ca5638caca7e172d59ea244f5f12d04c86d22dcbe2e219049a33ad318ffecc9aaff07c28ffe30aa69ebc109befa08acbcca

data/.gitignore

@@ -1 +1,2 @@
 *.gem
+.devcontainer

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    gemini-ai (1.0.0)
+    gemini-ai (2.1.0)
       event_stream_parser (~> 1.0)
       faraday (~> 2.7, >= 2.7.12)
       googleauth (~> 1.9, >= 1.9.1)
@@ -36,7 +36,7 @@ GEM
     method_source (1.0.0)
     multi_json (1.15.0)
     os (1.1.4)
-    parallel (1.23.0)
+    parallel (1.24.0)
     parser (3.2.2.4)
       ast (~> 2.4.1)
       racc

data/README.md

@@ -1,21 +1,46 @@
 # Gemini AI
 
-A Ruby Gem for interacting with [Gemini](https://deepmind.google/technologies/gemini/) through [Vertex AI](https://cloud.google.com/vertex-ai), Google's generative AI service.
+A Ruby Gem for interacting with [Gemini](https://deepmind.google/technologies/gemini/) through [Vertex AI](https://cloud.google.com/vertex-ai), [Generative Language API](https://ai.google.dev/api/rest), or [AI Studio](https://makersuite.google.com), Google's generative AI services.
+
+![The logo shows a gemstone split into red and blue halves, symbolizing Ruby programming and Gemini AI. It's surrounded by a circuit-like design on a dark blue backdrop.](https://raw.githubusercontent.com/gbaptista/assets/main/gemini-ai/ruby-gemini-ai.png)
 
 > _This Gem is designed to provide low-level access to Gemini, enabling people to build abstractions on top of it. If you are interested in more high-level abstractions or more user-friendly tools, you may want to consider [Nano Bots](https://github.com/icebaker/ruby-nano-bots) 💎 🤖._
 
 ## TL;DR and Quick Start
 
 ```ruby
-gem 'gemini-ai', '~> 1.0'
+gem 'gemini-ai', '~> 2.1.0'
 ```
 
 ```ruby
 require 'gemini-ai'
 
+# With an API key
+client = Gemini.new(
+  credentials: {
+    service: 'generative-language-api',
+    api_key: ENV['GOOGLE_API_KEY']
+  },
+  options: { model: 'gemini-pro', stream: false }
+)
+
+# With a Service Account Credentials File
+client = Gemini.new(
+  credentials: {
+    service: 'vertex-ai-api',
+    file_path: 'google-credentials.json',
+    region: 'us-east4'
+  },
+  options: { model: 'gemini-pro', stream: false }
+)
+
+# With Application Default Credentials
 client = Gemini.new(
-  credentials: { file_path: 'google-credentials.json', project_id: 'PROJECT_ID', region: 'us-east4' },
-  settings: { model: 'gemini-pro', stream: false }
+  credentials: {
+    service: 'vertex-ai-api',
+    region: 'us-east4'
+  },
+  options: { model: 'gemini-pro', stream: false }
 )
 
 result = client.stream_generate_content({
@@ -48,7 +73,11 @@ Result:
 - [TL;DR and Quick Start](#tldr-and-quick-start)
 - [Index](#index)
 - [Setup](#setup)
+    - [Installing](#installing)
     - [Credentials](#credentials)
+        - [Option 1: API Key (Generative Language API)](#option-1-api-key-generative-language-api)
+        - [Option 2: Service Account Credentials File (Vertex AI API)](#option-2-service-account-credentials-file-vertex-ai-api)
+        - [Option 3: Application Default Credentials (Vertex AI API)](#option-3-application-default-credentials-vertex-ai-api)
         - [Required Data](#required-data)
 - [Usage](#usage)
     - [Client](#client)
@@ -68,18 +97,31 @@ Result:
 
 ## Setup
 
+### Installing
+
 ```sh
-gem install gemini-ai -v 1.0.0
+gem install gemini-ai -v 2.1.0
 ```
 
 ```sh
-gem 'gemini-ai', '~> 1.0'
+gem 'gemini-ai', '~> 2.1.0'
 ```
 
 ### Credentials
 
 > ⚠️ DISCLAIMER: Be careful with what you are doing, and never trust others' code related to this. These commands and instructions alter the level of access to your Google Cloud Account, and running them naively can lead to security risks as well as financial risks. People with access to your account can use it to steal data or incur charges. Run these commands at your own responsibility and due diligence; expect no warranties from the contributors of this project.
 
+#### Option 1: API Key (Generative Language API)
+
+You need a [Google Cloud](https://console.cloud.google.com) [_Project_](https://cloud.google.com/resource-manager/docs/creating-managing-projects), and then you can generate an API Key through the Google Cloud Console [here](https://console.cloud.google.com/apis/credentials).
+
+You also need to enable the _Generative Language API_ service in your Google Cloud Console, which can be done [here](https://console.cloud.google.com/apis/library/generativelanguage.googleapis.com).
+
+
+Alternatively, you can generate an API Key through _Google AI Studio_ [here](https://makersuite.google.com/app/apikey). However, this approach will automatically create a project for you in your Google Cloud Account.
+
+#### Option 2: Service Account Credentials File (Vertex AI API)
+
 You need a [Google Cloud](https://console.cloud.google.com) [_Project_](https://cloud.google.com/resource-manager/docs/creating-managing-projects) and a [_Service Account_](https://cloud.google.com/iam/docs/service-account-overview) to use [Vertex AI](https://cloud.google.com/vertex-ai) API.
 
 After creating them, you need to enable the Vertex AI API for your project by clicking `Enable` here: [Vertex AI API](https://console.cloud.google.com/apis/library/aiplatform.googleapis.com).
@@ -132,16 +174,56 @@ gcloud projects add-iam-policy-binding PROJECT_ID \
   --role='roles/ml.admin'
 ```
 
-> ⚠️ DISCLAIMER: Be careful with what you are doing, and never trust others' code related to this. These commands and instructions alter the level of access to your Google Cloud Account, and running them naively can lead to security risks as well as financial risks. People with access to your account can use it to steal data or incur charges. Run these commands at your own responsibility and due diligence; expect no warranties from the contributors of this project.
+#### Option 3: Application Default Credentials (Vertex AI API)
+
+Similar to [Option 2](#option-2-service-account-credentials-file-vertex-ai-api), but you don't need to download a `google-credentials.json`. [_Application Default Credentials_](https://cloud.google.com/docs/authentication/application-default-credentials) automatically find credentials based on the application environment.
+
+For local development, you can generate your default credentials using the [gcloud CLI](https://cloud.google.com/sdk/gcloud) as follows:
+
+```sh
+gcloud auth application-default login 
+```
+
+For more details about alternative methods and different environments, check the official documentation:
+[Set up Application Default Credentials](https://cloud.google.com/docs/authentication/provide-credentials-adc)
 
 #### Required Data
 
-After this, you should have all the necessary data and access to use Gemini: a `google-credentials.json` file, a `PROJECT_ID`, and a `REGION`:
+After choosing an option, you should have all the necessary data and access to use Gemini.
+
+**Option 1**, for API Key:
+
+```ruby
+{
+  service: 'generative-language-api',
+  api_key: 'GOOGLE_API_KEY'
+}
+```
+
+Remember that hardcoding your API key in code is unsafe; it's preferable to use environment variables:
 
 ```ruby
 {
+  service: 'generative-language-api',
+  api_key: ENV['GOOGLE_API_KEY']
+}
+```
+
+**Option 2**: For the Service Account, provide a `google-credentials.json` file and a `REGION`:
+
+```ruby
+{
+  service: 'vertex-ai-api',
   file_path: 'google-credentials.json',
-  project_id: 'PROJECT_ID',
+  region: 'us-east4'
+}
+```
+
+**Option 3**: For _Application Default Credentials_, omit both the `api_key` and the `file_path`:
+
+```ruby
+{
+  service: 'vertex-ai-api',
   region: 'us-east4'
 }
 ```
@@ -160,6 +242,15 @@ Tokyo, Japan (asia-northeast1)
 
 You can follow here if new regions are available: [Gemini API](https://cloud.google.com/vertex-ai/docs/generative-ai/model-reference/gemini)
 
+You might want to explicitly set a Google Cloud Project ID, which you can do as follows:
+
+```ruby
+{
+  service: 'vertex-ai-api',
+  project_id: 'PROJECT_ID'
+}
+```
+
 ## Usage
 
 ### Client
@@ -169,9 +260,32 @@ Create a new client:
 ```ruby
 require 'gemini-ai'
 
+# With an API key
+client = Gemini.new(
+  credentials: {
+    service: 'generative-language-api',
+    api_key: ENV['GOOGLE_API_KEY']
+  },
+  options: { model: 'gemini-pro', stream: false }
+)
+
+# With a Service Account Credentials File
 client = Gemini.new(
-  credentials: { file_path: 'google-credentials.json', project_id: 'PROJECT_ID', region: 'us-east4' },
-  settings: { model: 'gemini-pro', stream: false }
+  credentials: {
+    service: 'vertex-ai-api',
+    file_path: 'google-credentials.json',
+    region: 'us-east4'
+  },
+  options: { model: 'gemini-pro', stream: false }
+)
+
+# With Application Default Credentials
+client = Gemini.new(
+  credentials: {
+    service: 'vertex-ai-api',
+    region: 'us-east4'
+  },
+  options: { model: 'gemini-pro', stream: false }
 )
 ```
 
@@ -210,8 +324,8 @@ Result:
 You can set up the client to use streaming for all supported endpoints:
 ```ruby
 client = Gemini.new(
-  credentials: { file_path: 'google-credentials.json', project_id: 'PROJECT_ID', region: 'us-east4' },
-  settings: { model: 'gemini-pro', stream: true }
+  credentials: { ... },
+  options: { model: 'gemini-pro', stream: true }
 )
 ```
 
@@ -328,7 +442,7 @@ Result:
 
 ### Tools (Functions) Calling
 
-> As of the writing of this README, only the `gemini-pro` model [supports](https://cloud.google.com/vertex-ai/docs/generative-ai/multimodal/function-calling#supported_models) tools (functions) calls.
+> As of the writing of this README, only the `vertex-ai-api` service and the `gemini-pro` model [supports](https://cloud.google.com/vertex-ai/docs/generative-ai/multimodal/function-calling#supported_models) tools (functions) calls.
 
 You can provide specifications for [tools (functions)](https://cloud.google.com/vertex-ai/docs/generative-ai/multimodal/function-calling) using [JSON Schema](https://json-schema.org) to generate potential calls to them:
 
@@ -500,11 +614,17 @@ gem build gemini-ai.gemspec
 
 gem signin
 
-gem push gemini-ai-1.0.0.gem
+gem push gemini-ai-2.1.0.gem
 ```
 
 ### Updating the README
 
+Install [Babashka](https://babashka.org):
+
+```sh
+curl -s https://raw.githubusercontent.com/babashka/babashka/master/install | sudo bash
+```
+
 Update the `template.md` file and then:
 
 ```sh
@@ -532,6 +652,8 @@ mlp README.md -p 8076
 
 These resources and references may be useful throughout your learning process.
 
+- [Google AI for Developers](https://ai.google.dev)
+- [Get started with the Gemini API ](https://ai.google.dev/docs)
 - [Getting Started with the Vertex AI Gemini API with cURL](https://github.com/GoogleCloudPlatform/generative-ai/blob/main/gemini/getting-started/intro_gemini_curl.ipynb)
 - [Gemini API Documentation](https://cloud.google.com/vertex-ai/docs/generative-ai/model-reference/gemini)
 - [Vertex AI API Documentation](https://cloud.google.com/vertex-ai/docs/reference)
@@ -544,4 +666,4 @@ These resources and references may be useful throughout your learning process.
 
 This is not an official Google project, nor is it affiliated with Google in any way.
 
-The software is distributed under the MIT License, which can be found at [https://github.com/gbaptista/gemini-ai/blob/main/LICENSE](https://github.com/gbaptista/gemini-ai/blob/main/LICENSE). This license includes a disclaimer of warranty. Moreover, the authors assume no responsibility for any damage or costs that may result from using this project. Use the Gemini AI Ruby Gem at your own risk.
+This software is distributed under the [MIT License](https://github.com/gbaptista/gemini-ai/blob/main/LICENSE). This license includes a disclaimer of warranty. Moreover, the authors assume no responsibility for any damage or costs that may result from using this project. Use the Gemini AI Ruby Gem at your own risk.

data/controllers/client.rb

@@ -9,14 +9,40 @@ module Gemini
   module Controllers
     class Client
       def initialize(config)
-        @authorizer = ::Google::Auth::ServiceAccountCredentials.make_creds(
-          json_key_io: File.open(config[:credentials][:file_path]),
-          scope: 'https://www.googleapis.com/auth/cloud-platform'
-        )
+        if config[:credentials][:api_key]
+          @authentication = :api_key
+          @api_key = config[:credentials][:api_key]
+        elsif config[:credentials][:file_path]
+          @authentication = :service_account
+          @authorizer = ::Google::Auth::ServiceAccountCredentials.make_creds(
+            json_key_io: File.open(config[:credentials][:file_path]),
+            scope: 'https://www.googleapis.com/auth/cloud-platform'
+          )
+        else
+          @authentication = :default_credentials
+          @authorizer = ::Google::Auth.get_application_default
+        end
+
+        if @authentication == :service_account || @authentication == :default_credentials
+          @project_id = if config[:credentials][:project_id].nil?
+                          @authorizer.project_id || @authorizer.quota_project_id
+                        else
+                          config[:credentials][:project_id]
+                        end
+
+          raise StandardError, 'Could not determine project_id, which is required.' if @project_id.nil?
+        end
 
-        @address = "https://#{config[:credentials][:region]}-aiplatform.googleapis.com/v1/projects/#{config[:credentials][:project_id]}/locations/#{config[:credentials][:region]}/publishers/google/models/#{config[:settings][:model]}"
+        @address = case config[:credentials][:service]
+                   when 'vertex-ai-api'
+                     "https://#{config[:credentials][:region]}-aiplatform.googleapis.com/v1/projects/#{@project_id}/locations/#{config[:credentials][:region]}/publishers/google/models/#{config[:options][:model]}"
+                   when 'generative-language-api'
+                     "https://generativelanguage.googleapis.com/v1/models/#{config[:options][:model]}"
+                   else
+                     raise StandardError, "Unsupported service: #{config[:credentials][:service]}"
+                   end
 
-        @stream = config[:settings][:stream]
+        @stream = config[:options][:stream]
       end
 
       def stream_generate_content(payload, stream: nil, &callback)
@@ -26,7 +52,12 @@ module Gemini
       def request(path, payload, stream: nil, &callback)
         stream_enabled = stream.nil? ? @stream : stream
         url = "#{@address}:#{path}"
-        url += '?alt=sse' if stream_enabled
+        params = []
+
+        params << 'alt=sse' if stream_enabled
+        params << "key=#{@api_key}" if @authentication == :api_key
+
+        url += "?#{params.join('&')}" if params.size.positive?
 
         if !callback.nil? && !stream_enabled
           raise StandardError, 'You are trying to use a block without stream enabled."'
@@ -37,7 +68,10 @@ module Gemini
         response = Faraday.new.post do |request|
           request.url url
           request.headers['Content-Type'] = 'application/json'
-          request.headers['Authorization'] = "Bearer #{@authorizer.fetch_access_token!['access_token']}"
+          if @authentication == :service_account || @authentication == :default_credentials
+            request.headers['Authorization'] = "Bearer #{@authorizer.fetch_access_token!['access_token']}"
+          end
+
           request.body = payload.to_json
 
           if stream_enabled

data/static/gem.rb

@@ -3,10 +3,10 @@
 module Gemini
   GEM = {
     name: 'gemini-ai',
-    version: '1.0.0',
+    version: '2.1.0',
     author: 'gbaptista',
     summary: "Interact with Google's Gemini AI.",
-    description: "A Ruby Gem for interacting with Gemini through Vertex AI, Google's generative AI service.",
+    description: "A Ruby Gem for interacting with Gemini through Vertex AI, Generative Language API, or AI Studio, Google's generative AI services.",
     github: 'https://github.com/gbaptista/gemini-ai',
     gem_server: 'https://rubygems.org',
     license: 'MIT',

data/template.md

@@ -1,21 +1,46 @@
 # Gemini AI
 
-A Ruby Gem for interacting with [Gemini](https://deepmind.google/technologies/gemini/) through [Vertex AI](https://cloud.google.com/vertex-ai), Google's generative AI service.
+A Ruby Gem for interacting with [Gemini](https://deepmind.google/technologies/gemini/) through [Vertex AI](https://cloud.google.com/vertex-ai), [Generative Language API](https://ai.google.dev/api/rest), or [AI Studio](https://makersuite.google.com), Google's generative AI services.
+
+![The logo shows a gemstone split into red and blue halves, symbolizing Ruby programming and Gemini AI. It's surrounded by a circuit-like design on a dark blue backdrop.](https://raw.githubusercontent.com/gbaptista/assets/main/gemini-ai/ruby-gemini-ai.png)
 
 > _This Gem is designed to provide low-level access to Gemini, enabling people to build abstractions on top of it. If you are interested in more high-level abstractions or more user-friendly tools, you may want to consider [Nano Bots](https://github.com/icebaker/ruby-nano-bots) 💎 🤖._
 
 ## TL;DR and Quick Start
 
 ```ruby
-gem 'gemini-ai', '~> 1.0'
+gem 'gemini-ai', '~> 2.1.0'
 ```
 
 ```ruby
 require 'gemini-ai'
 
+# With an API key
+client = Gemini.new(
+  credentials: {
+    service: 'generative-language-api',
+    api_key: ENV['GOOGLE_API_KEY']
+  },
+  options: { model: 'gemini-pro', stream: false }
+)
+
+# With a Service Account Credentials File
+client = Gemini.new(
+  credentials: {
+    service: 'vertex-ai-api',
+    file_path: 'google-credentials.json',
+    region: 'us-east4'
+  },
+  options: { model: 'gemini-pro', stream: false }
+)
+
+# With Application Default Credentials
 client = Gemini.new(
-  credentials: { file_path: 'google-credentials.json', project_id: 'PROJECT_ID', region: 'us-east4' },
-  settings: { model: 'gemini-pro', stream: false }
+  credentials: {
+    service: 'vertex-ai-api',
+    region: 'us-east4'
+  },
+  options: { model: 'gemini-pro', stream: false }
 )
 
 result = client.stream_generate_content({
@@ -49,18 +74,31 @@ Result:
 
 ## Setup
 
+### Installing
+
 ```sh
-gem install gemini-ai -v 1.0.0
+gem install gemini-ai -v 2.1.0
 ```
 
 ```sh
-gem 'gemini-ai', '~> 1.0'
+gem 'gemini-ai', '~> 2.1.0'
 ```
 
 ### Credentials
 
 > ⚠️ DISCLAIMER: Be careful with what you are doing, and never trust others' code related to this. These commands and instructions alter the level of access to your Google Cloud Account, and running them naively can lead to security risks as well as financial risks. People with access to your account can use it to steal data or incur charges. Run these commands at your own responsibility and due diligence; expect no warranties from the contributors of this project.
 
+#### Option 1: API Key (Generative Language API)
+
+You need a [Google Cloud](https://console.cloud.google.com) [_Project_](https://cloud.google.com/resource-manager/docs/creating-managing-projects), and then you can generate an API Key through the Google Cloud Console [here](https://console.cloud.google.com/apis/credentials).
+
+You also need to enable the _Generative Language API_ service in your Google Cloud Console, which can be done [here](https://console.cloud.google.com/apis/library/generativelanguage.googleapis.com).
+
+
+Alternatively, you can generate an API Key through _Google AI Studio_ [here](https://makersuite.google.com/app/apikey). However, this approach will automatically create a project for you in your Google Cloud Account.
+
+#### Option 2: Service Account Credentials File (Vertex AI API)
+
 You need a [Google Cloud](https://console.cloud.google.com) [_Project_](https://cloud.google.com/resource-manager/docs/creating-managing-projects) and a [_Service Account_](https://cloud.google.com/iam/docs/service-account-overview) to use [Vertex AI](https://cloud.google.com/vertex-ai) API.
 
 After creating them, you need to enable the Vertex AI API for your project by clicking `Enable` here: [Vertex AI API](https://console.cloud.google.com/apis/library/aiplatform.googleapis.com).
@@ -113,16 +151,56 @@ gcloud projects add-iam-policy-binding PROJECT_ID \
   --role='roles/ml.admin'
 ```
 
-> ⚠️ DISCLAIMER: Be careful with what you are doing, and never trust others' code related to this. These commands and instructions alter the level of access to your Google Cloud Account, and running them naively can lead to security risks as well as financial risks. People with access to your account can use it to steal data or incur charges. Run these commands at your own responsibility and due diligence; expect no warranties from the contributors of this project.
+#### Option 3: Application Default Credentials (Vertex AI API)
+
+Similar to [Option 2](#option-2-service-account-credentials-file-vertex-ai-api), but you don't need to download a `google-credentials.json`. [_Application Default Credentials_](https://cloud.google.com/docs/authentication/application-default-credentials) automatically find credentials based on the application environment.
+
+For local development, you can generate your default credentials using the [gcloud CLI](https://cloud.google.com/sdk/gcloud) as follows:
+
+```sh
+gcloud auth application-default login 
+```
+
+For more details about alternative methods and different environments, check the official documentation:
+[Set up Application Default Credentials](https://cloud.google.com/docs/authentication/provide-credentials-adc)
 
 #### Required Data
 
-After this, you should have all the necessary data and access to use Gemini: a `google-credentials.json` file, a `PROJECT_ID`, and a `REGION`:
+After choosing an option, you should have all the necessary data and access to use Gemini.
+
+**Option 1**, for API Key:
+
+```ruby
+{
+  service: 'generative-language-api',
+  api_key: 'GOOGLE_API_KEY'
+}
+```
+
+Remember that hardcoding your API key in code is unsafe; it's preferable to use environment variables:
 
 ```ruby
 {
+  service: 'generative-language-api',
+  api_key: ENV['GOOGLE_API_KEY']
+}
+```
+
+**Option 2**: For the Service Account, provide a `google-credentials.json` file and a `REGION`:
+
+```ruby
+{
+  service: 'vertex-ai-api',
   file_path: 'google-credentials.json',
-  project_id: 'PROJECT_ID',
+  region: 'us-east4'
+}
+```
+
+**Option 3**: For _Application Default Credentials_, omit both the `api_key` and the `file_path`:
+
+```ruby
+{
+  service: 'vertex-ai-api',
   region: 'us-east4'
 }
 ```
@@ -141,6 +219,15 @@ Tokyo, Japan (asia-northeast1)
 
 You can follow here if new regions are available: [Gemini API](https://cloud.google.com/vertex-ai/docs/generative-ai/model-reference/gemini)
 
+You might want to explicitly set a Google Cloud Project ID, which you can do as follows:
+
+```ruby
+{
+  service: 'vertex-ai-api',
+  project_id: 'PROJECT_ID'
+}
+```
+
 ## Usage
 
 ### Client
@@ -150,9 +237,32 @@ Create a new client:
 ```ruby
 require 'gemini-ai'
 
+# With an API key
+client = Gemini.new(
+  credentials: {
+    service: 'generative-language-api',
+    api_key: ENV['GOOGLE_API_KEY']
+  },
+  options: { model: 'gemini-pro', stream: false }
+)
+
+# With a Service Account Credentials File
 client = Gemini.new(
-  credentials: { file_path: 'google-credentials.json', project_id: 'PROJECT_ID', region: 'us-east4' },
-  settings: { model: 'gemini-pro', stream: false }
+  credentials: {
+    service: 'vertex-ai-api',
+    file_path: 'google-credentials.json',
+    region: 'us-east4'
+  },
+  options: { model: 'gemini-pro', stream: false }
+)
+
+# With Application Default Credentials
+client = Gemini.new(
+  credentials: {
+    service: 'vertex-ai-api',
+    region: 'us-east4'
+  },
+  options: { model: 'gemini-pro', stream: false }
 )
 ```
 
@@ -191,8 +301,8 @@ Result:
 You can set up the client to use streaming for all supported endpoints:
 ```ruby
 client = Gemini.new(
-  credentials: { file_path: 'google-credentials.json', project_id: 'PROJECT_ID', region: 'us-east4' },
-  settings: { model: 'gemini-pro', stream: true }
+  credentials: { ... },
+  options: { model: 'gemini-pro', stream: true }
 )
 ```
 
@@ -309,7 +419,7 @@ Result:
 
 ### Tools (Functions) Calling
 
-> As of the writing of this README, only the `gemini-pro` model [supports](https://cloud.google.com/vertex-ai/docs/generative-ai/multimodal/function-calling#supported_models) tools (functions) calls.
+> As of the writing of this README, only the `vertex-ai-api` service and the `gemini-pro` model [supports](https://cloud.google.com/vertex-ai/docs/generative-ai/multimodal/function-calling#supported_models) tools (functions) calls.
 
 You can provide specifications for [tools (functions)](https://cloud.google.com/vertex-ai/docs/generative-ai/multimodal/function-calling) using [JSON Schema](https://json-schema.org) to generate potential calls to them:
 
@@ -481,11 +591,17 @@ gem build gemini-ai.gemspec
 
 gem signin
 
-gem push gemini-ai-1.0.0.gem
+gem push gemini-ai-2.1.0.gem
 ```
 
 ### Updating the README
 
+Install [Babashka](https://babashka.org):
+
+```sh
+curl -s https://raw.githubusercontent.com/babashka/babashka/master/install | sudo bash
+```
+
 Update the `template.md` file and then:
 
 ```sh
@@ -513,6 +629,8 @@ mlp README.md -p 8076
 
 These resources and references may be useful throughout your learning process.
 
+- [Google AI for Developers](https://ai.google.dev)
+- [Get started with the Gemini API ](https://ai.google.dev/docs)
 - [Getting Started with the Vertex AI Gemini API with cURL](https://github.com/GoogleCloudPlatform/generative-ai/blob/main/gemini/getting-started/intro_gemini_curl.ipynb)
 - [Gemini API Documentation](https://cloud.google.com/vertex-ai/docs/generative-ai/model-reference/gemini)
 - [Vertex AI API Documentation](https://cloud.google.com/vertex-ai/docs/reference)
@@ -525,4 +643,4 @@ These resources and references may be useful throughout your learning process.
 
 This is not an official Google project, nor is it affiliated with Google in any way.
 
-The software is distributed under the MIT License, which can be found at [https://github.com/gbaptista/gemini-ai/blob/main/LICENSE](https://github.com/gbaptista/gemini-ai/blob/main/LICENSE). This license includes a disclaimer of warranty. Moreover, the authors assume no responsibility for any damage or costs that may result from using this project. Use the Gemini AI Ruby Gem at your own risk.
+This software is distributed under the [MIT License](https://github.com/gbaptista/gemini-ai/blob/main/LICENSE). This license includes a disclaimer of warranty. Moreover, the authors assume no responsibility for any damage or costs that may result from using this project. Use the Gemini AI Ruby Gem at your own risk.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: gemini-ai
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 2.1.0
 platform: ruby
 authors:
 - gbaptista
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-12-14 00:00:00.000000000 Z
+date: 2023-12-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: event_stream_parser
@@ -64,8 +64,8 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 1.9.1
-description: A Ruby Gem for interacting with Gemini through Vertex AI, Google's generative
-  AI service.
+description: A Ruby Gem for interacting with Gemini through Vertex AI, Generative
+  Language API, or AI Studio, Google's generative AI services.
 email: 
 executables: []
 extensions: []
@@ -107,7 +107,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.22
+rubygems_version: 3.3.3
 signing_key: 
 specification_version: 4
 summary: Interact with Google's Gemini AI.