routerbase-client 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: a0bbc0d84f35cfafc7c9403eb02408d2ca06d311b8794b5268b61550a8ea3503
+  data.tar.gz: 660e84a0786913247bb0177df877314cf366f00a54df32fe3de041fc76357fb3
+SHA512:
+  metadata.gz: 594aed71a20bf6b8241bb7d8c3b2c15a513b99cd4564816859f72cdd3011676097da357c0c441aed79316c9fdac74c7b3bf5c6df820367896e72d37b088b67ed
+  data.tar.gz: 3449c0fec7ea0244eb354ce40a116a583f0e2db59a912c33410286ef13054edcaedc5b839403beb721742c7c9b9d131ad6b7de61c2ae54be4beb430d692f6a35

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 RouterBase Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,53 @@
+# RouterBase Ruby Client
+
+[RouterBase](https://routerbase.com) provides an OpenAI-compatible API for calling many AI models through `https://routerbase.com/v1`.
+
+`routerbase-client` is a dependency-free Ruby client and CLI for chat completions and model listing. It is prepared for RubyGems publishing without GitHub metadata while that publishing line is paused.
+
+## Install
+
+After publishing to RubyGems:
+
+```bash
+gem install routerbase-client
+```
+
+For local testing:
+
+```bash
+gem build routerbase-client.gemspec
+gem install ./routerbase-client-0.1.0.gem
+```
+
+## Usage
+
+```ruby
+require "routerbase"
+
+client = RouterBase::Client.new(api_key: ENV.fetch("ROUTERBASE_API_KEY"))
+response = client.chat_completion(
+  messages: [
+    { role: "user", content: "Write a short RouterBase tagline." }
+  ]
+)
+
+puts response.fetch("choices").first.fetch("message").fetch("content")
+```
+
+## CLI
+
+```bash
+export ROUTERBASE_API_KEY="sk-rb-..."
+routerbase-chat "Write a five-word launch tagline"
+```
+
+## Links
+
+- [RouterBase](https://routerbase.com)
+- RouterBase docs: https://docs.routerbase.com/
+- Chat completions docs: https://docs.routerbase.com/api-reference/chat-completions
+- npm quickstart package: https://www.npmjs.com/package/routerbase-quickstart
+
+## License
+
+MIT

data/exe/routerbase-chat

@@ -0,0 +1,24 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "json"
+require "routerbase"
+
+prompt = ARGV.join(" ").strip
+
+if prompt.empty?
+  warn "Usage: routerbase-chat \"Write a short RouterBase tagline\""
+  exit 1
+end
+
+client = RouterBase::Client.new
+response = client.chat_completion(
+  messages: [
+    {
+      role: "user",
+      content: prompt
+    }
+  ]
+)
+
+puts response.fetch("choices").first.fetch("message").fetch("content")

data/lib/routerbase/client.rb

@@ -0,0 +1,81 @@
+require "json"
+require "net/http"
+require "uri"
+
+module RouterBase
+  class Error < StandardError; end
+
+  class Client
+    attr_reader :api_key, :base_url, :transport
+
+    def initialize(api_key: ENV["ROUTERBASE_API_KEY"], base_url: BASE_URL, transport: nil)
+      raise ArgumentError, "RouterBase API key is required" if api_key.nil? || api_key.empty?
+
+      @api_key = api_key
+      @base_url = base_url.sub(%r{/+\z}, "")
+      @transport = transport || NetHTTPTransport.new
+    end
+
+    def chat_completion(messages:, model: DEFAULT_MODEL, **options)
+      raise ArgumentError, "messages must be a non-empty array" if messages.nil? || messages.empty?
+
+      post_json(
+        "/chat/completions",
+        {
+          model: model,
+          messages: messages
+        }.merge(options)
+      )
+    end
+
+    def list_models
+      request_json(:get, "/models")
+    end
+
+    private
+
+    def post_json(path, payload)
+      request_json(:post, path, payload)
+    end
+
+    def request_json(method, path, payload = nil)
+      uri = URI("#{base_url}#{path}")
+      response = transport.request(
+        method: method,
+        uri: uri,
+        headers: headers(payload),
+        body: payload.nil? ? nil : JSON.generate(payload)
+      )
+
+      parsed = response.body.nil? || response.body.empty? ? {} : JSON.parse(response.body)
+      return parsed if response.code.to_i.between?(200, 299)
+
+      message = parsed.dig("error", "message") || parsed["msg"] || response.body
+      raise Error, "RouterBase request failed (#{response.code}): #{message}"
+    end
+
+    def headers(payload)
+      values = {
+        "Authorization" => "Bearer #{api_key}"
+      }
+      values["Content-Type"] = "application/json" unless payload.nil?
+      values
+    end
+  end
+
+  class NetHTTPTransport
+    Response = Struct.new(:code, :body, keyword_init: true)
+
+    def request(method:, uri:, headers:, body: nil)
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = uri.scheme == "https"
+
+      request = method == :get ? Net::HTTP::Get.new(uri) : Net::HTTP::Post.new(uri)
+      headers.each { |key, value| request[key] = value }
+      request.body = body unless body.nil?
+
+      response = http.request(request)
+      Response.new(code: response.code, body: response.body)
+    end
+  end
+end

data/lib/routerbase/version.rb

@@ -0,0 +1,3 @@
+module RouterBase
+  VERSION = "0.1.0"
+end

data/lib/routerbase.rb

@@ -0,0 +1,7 @@
+require_relative "routerbase/client"
+require_relative "routerbase/version"
+
+module RouterBase
+  BASE_URL = ENV.fetch("ROUTERBASE_BASE_URL", "https://routerbase.com/v1").sub(%r{/+\z}, "")
+  DEFAULT_MODEL = "google/gemini-2.5-flash"
+end

metadata

@@ -0,0 +1,53 @@
+--- !ruby/object:Gem::Specification
+name: routerbase-client
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- RouterBase Contributors
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2026-07-01 00:00:00.000000000 Z
+dependencies: []
+description: A dependency-free Ruby client and CLI for RouterBase chat completions
+  and model listing.
+email: 
+executables:
+- routerbase-chat
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- exe/routerbase-chat
+- lib/routerbase.rb
+- lib/routerbase/client.rb
+- lib/routerbase/version.rb
+homepage: https://routerbase.com
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://routerbase.com
+  documentation_uri: https://docs.routerbase.com/
+  bug_tracker_uri: https://routerbase.com
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.6'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.3.1
+signing_key: 
+specification_version: 4
+summary: Dependency-free Ruby client for the RouterBase OpenAI-compatible API.
+test_files: []