genai-rb 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ba4f68bb9f9fb0a8aedbe47bc8e81f2859f7418f049a6d9610b7f32982a09e0f
-  data.tar.gz: '08bb6995fb0b749cdadde7a6be83373c53db9033ec03b8d8bc5228cf7f74ed4a'
+  metadata.gz: 8418d629d5c593b1900b31e44637a6b3fa494411d77e52a4c1dbd7004d36b2ff
+  data.tar.gz: 1a1913a35895c991249dd5c4e5048ca376a7605c46f8f650ef15f11b92b9e54f
 SHA512:
-  metadata.gz: 6fb0326f7a91add9c63a3fc1876b0360345bb6176763b708fca4a7c1a9408a77c0d422ad658fce4127458a876cb8727a67eccbb4c71f1ebe60704eacd519cf84
-  data.tar.gz: 4ebf4cfc65b6d21be25ced6dc666795b4110e9d4adc3d2538e32760bbf69e8af61cdb441fd692e98969aef51993a05c3da04f7f7be209334f15903fc9995e940
+  metadata.gz: ac01403695c45ebced2ec88afaa18ddbd2ad2e22d2a022a3d688907491650dd3d43793fcfb9e517ecc9471cb928d9bd54a3ee4e96bc1fe3c27e9513a2f2c4b8c
+  data.tar.gz: 7fc52345aea27e0d0350b38fe4f71a294eedcef76096b9d558c832ef6cd5f5a2d476748bd30eded89ae68a3fad44fd0be3a761fb64401a5f7332edd668ef86e6

data/CHANGELOG.md

@@ -2,4 +2,10 @@
 
 ## [0.1.0] - 2025-08-16 (Glass Bead)
 
-- Initial release
+- Initial release
+
+## [0.2.0] - 2026-07-31 (Me gustas tu)
+
+- Switch from Gemini-only requests to OpenAI-compatible chat completions.
+- Use `OPENAI_API_KEY` and optional `OPENAI_BASE_URL`.
+- Update examples and documentation for OpenAI-compatible providers.

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2025 Siruu580
+Copyright (c) 2025-2026 qweruby
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -1,107 +1,156 @@
-
-# Genai
-
-An unofficial Ruby package for Google Gemini. Easily generate text and images, analyze web content, and integrate Google Search—all with a simple Ruby API.
-
-## Installation
-
-Add to your Gemfile:
-
-```ruby
-gem 'genai-rb'
-```
-
-Then run:
-
-```bash
-bundle install
-```
-
-Or install directly:
-
-```bash
-gem install genai-rb
-```
-
-## Usage
-
-### Setup
-
-Get your Gemini API key from [Google AI Studio](https://makersuite.google.com/app/apikey).
-
-Set your API key:
-
-```bash
-export GEMINI_API_KEY="api_key"
-```
-
-Or pass it directly:
-
-```ruby
-require 'genai'
-client = Genai.new(api_key: "api_key")
-```
-
-### Text Generation
-
-```ruby
-response = client.generate_content(contents: "Hello, how are you?")
-puts response
-```
-
-### Use a Specific Model
-
-```ruby
-response = client.generate_content(model_id: "gemini-2.5-flash", contents: "Explain quantum computing.")
-```
-
-### URL Context
-
-```ruby
-response = client.generate_content(contents: "Summarize: https://example.com/article", tools: [:url_context])
-```
-
-### Google Search Integration
-
-```ruby
-response = client.generate_content(contents: "Latest AI news?", tools: [:google_search, :url_context])
-```
-
-### Advanced Configuration
-
-```ruby
-client = Genai.new(api_key: "api_key", timeout: 120, max_retries: 5)
-response = client.model("gemini-2.0-flash").generate_content(
-  contents: "Write a creative story about a robot learning to paint",
-  config: { temperature: 0.8, max_output_tokens: 1000 }
-)
-```
-
-### Model Instances
-
-```ruby
-model = client.model("gemini-2.5-flash")
-response = model.generate_content(contents: "Explain the benefits of renewable energy")
-```
-
-## Supported Models
-
-- All Gemini models
-
-## Features
-
-- Text and image generation
-- URL context analysis
-- Google Search integration
-- Multiple model support
-- Customizable generation config
-- Robust error handling and retry logic
-- Simple, intuitive Ruby API
-
-## Contributing
-
-Pull requests are always welcome.
-
-## License
-
-Open source under the [MIT License](https://opensource.org/licenses/MIT).
+# Genai
+
+OpenAI-compatible chat completions for Ruby.
+
+## Installation
+
+Add the gem to your Gemfile:
+
+```ruby
+gem "genai-rb"
+```
+
+Install dependencies:
+
+```bash
+bundle install
+```
+
+Or install it directly:
+
+```bash
+gem install genai-rb
+```
+
+## Setup
+
+Set your API key:
+
+```bash
+export OPENAI_API_KEY="api_key"
+```
+
+By default, requests go to:
+
+```text
+https://api.openai.com/v1
+```
+
+For another OpenAI-compatible provider, set `OPENAI_BASE_URL` with `/v1` included:
+
+```bash
+export OPENAI_BASE_URL="https://api.example.com/v1"
+```
+
+For Gemini's OpenAI-compatible endpoint:
+
+```bash
+export OPENAI_API_KEY="gemini_api_key"
+export OPENAI_BASE_URL="https://generativelanguage.googleapis.com/v1beta/openai"
+```
+
+You can also pass values in Ruby:
+
+```ruby
+require "genai"
+
+client = Genai.new(
+  api_key: "api_key",
+  base_url: "https://api.openai.com/v1"
+)
+```
+
+## Quick Start
+
+```ruby
+require "genai"
+
+client = Genai.new
+
+response = client.generate_content(contents: "Hello, how are you?")
+puts response
+```
+
+The default model is `gpt-5.5`.
+
+Run the included example:
+
+```bash
+ruby example.rb
+```
+
+Edit the variables at the top of `example.rb` to change providers:
+
+```ruby
+api_key = "your_api_key"
+base_url = "https://api.openai.com/v1"
+model = "gpt-5.5"
+```
+
+For Gemini's OpenAI-compatible endpoint:
+
+```ruby
+api_key = "your_gemini_api_key"
+base_url = "https://generativelanguage.googleapis.com/v1beta/openai"
+model = "gemini-2.5-flash"
+```
+
+## Choosing A Model
+
+```ruby
+response = client.generate_content(
+  model: "gpt-5.5",
+  contents: "Explain quantum computing."
+)
+
+puts response
+```
+
+## Configuration
+
+Pass OpenAI chat completion options with `config`:
+
+```ruby
+response = client.generate_content(
+  contents: "Write a short story about a robot learning to paint.",
+  config: {
+    temperature: 0.8,
+    max_tokens: 1000
+  }
+)
+```
+
+`max_output_tokens` is accepted as an alias for `max_tokens`.
+
+## Messages
+
+Use OpenAI-style messages when you need system or multi-turn context:
+
+```ruby
+response = client.generate_content(
+  contents: [
+    { role: "system", content: "Answer briefly." },
+    { role: "user", content: "0.1 + 0.2 == 0.3? Explain." }
+  ]
+)
+
+puts response
+```
+
+## Chat Sessions
+
+```ruby
+chat = client.chats.create(model: "gpt-5.5")
+
+puts chat.send_message("a = 231018")
+puts chat.send_message("What is a?")
+```
+
+## Supported APIs
+
+- OpenAI Chat Completions API
+- OpenAI-compatible `/v1/chat/completions` providers
+
+## License
+
+Open source under the [MIT License](https://opensource.org/licenses/MIT).