turborag 0.5.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 1cc6fcd1aa419dfd220cdc266013202acf0cc0f776772b779175aaf64493f423
+  data.tar.gz: 1fe99d19c27e42f523499682a4d83f1a3ac09898d8e4dbbd53a83c5dca9d716e
+SHA512:
+  metadata.gz: 62253f8b873f76877b4e0a435e49a65dbbfdda1d2dead8cfa2e9864e6743cb503bf713adb2a12efa5b1227d437deb29726f47cb8c18e6698214a7d335b3e3eea
+  data.tar.gz: 0c2e86110b7aea52109b65a23effc53edf174fb92138a4ce6f1ee2eaa40b5a15d534738cc420a646766e8fec89bc6f166b141f6742c24d59d1219b67e916cf97

data/lib/turborag.rb

@@ -0,0 +1,122 @@
+# frozen_string_literal: true
+
+# TurboRAG Ruby client — typed wrapper over the TurboRAG HTTP API.
+# Zero dependencies beyond stdlib (net/http, json).
+#
+# Usage:
+#   client = TurboRAG::Client.new("http://localhost:8080")
+#   results = client.query(vector: [0.1, 0.2, 0.3], top_k: 5)
+
+require "net/http"
+require "json"
+require "uri"
+
+module TurboRAG
+  class Error < StandardError
+    attr_reader :status, :body
+
+    def initialize(status, body)
+      @status = status
+      @body = body
+      super("TurboRAG HTTP #{status}: #{body}")
+    end
+  end
+
+  class Client
+    # @param base_url [String] TurboRAG server URL (e.g. "http://localhost:8080")
+    # @param timeout [Integer] request timeout in seconds (default: 30)
+    def initialize(base_url, timeout: 30)
+      @base_uri = URI.parse(base_url.chomp("/"))
+      @timeout = timeout
+    end
+
+    # Search by embedding vector.
+    # @param vector [Array<Float>]
+    # @param top_k [Integer]
+    # @return [Hash] { "count" => N, "results" => [...] }
+    def query(vector:, top_k: 5)
+      post("/query", { query_vector: vector, top_k: top_k })
+    end
+
+    # Search by text (requires --model on the server).
+    # @param text [String]
+    # @param top_k [Integer]
+    # @return [Hash]
+    def query_text(text:, top_k: 5)
+      post("/query", { query_text: text, top_k: top_k })
+    end
+
+    # Batch vector search.
+    # @param queries [Array<Hash>] each with :vector key
+    # @param top_k [Integer]
+    # @return [Hash]
+    def query_batch(queries:, top_k: 5)
+      payload = {
+        queries: queries.map { |q| { query_vector: q[:vector] } },
+        top_k: top_k,
+      }
+      post("/query/batch", payload)
+    end
+
+    # Add records with precomputed embeddings.
+    # @param records [Array<Hash>] each with :chunk_id, :text, :embedding
+    # @return [Hash]
+    def ingest(records:)
+      post("/ingest", { records: records })
+    end
+
+    # Ingest raw text with auto-chunking (requires --model).
+    # @param text [String]
+    # @param source_doc [String, nil]
+    # @return [Hash]
+    def ingest_text(text:, source_doc: nil)
+      post("/ingest-text", { text: text, source_doc: source_doc })
+    end
+
+    # Health check.
+    # @return [Hash]
+    def health
+      get("/health")
+    end
+
+    # Index configuration and stats.
+    # @return [Hash]
+    def index
+      get("/index")
+    end
+
+    # Latency and error metrics.
+    # @return [Hash]
+    def metrics
+      get("/metrics")
+    end
+
+    private
+
+    def get(path)
+      uri = URI.join(@base_uri.to_s, path)
+      req = Net::HTTP::Get.new(uri)
+      execute(uri, req)
+    end
+
+    def post(path, body)
+      uri = URI.join(@base_uri.to_s, path)
+      req = Net::HTTP::Post.new(uri)
+      req["Content-Type"] = "application/json"
+      req.body = JSON.generate(body)
+      execute(uri, req)
+    end
+
+    def execute(uri, req)
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = (uri.scheme == "https")
+      http.open_timeout = @timeout
+      http.read_timeout = @timeout
+
+      res = http.request(req)
+      raise Error.new(res.code.to_i, res.body) unless res.is_a?(Net::HTTPSuccess)
+
+      JSON.parse(res.body)
+    end
+  end
+end

metadata

@@ -0,0 +1,44 @@
+--- !ruby/object:Gem::Specification
+name: turborag
+version: !ruby/object:Gem::Version
+  version: 0.5.1
+platform: ruby
+authors:
+- Ratnam Shah
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2026-04-28 00:00:00.000000000 Z
+dependencies: []
+description: Typed wrapper over the TurboRAG HTTP API for compressed vector search.
+  Zero dependencies beyond stdlib.
+email: 
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/turborag.rb
+homepage: https://github.com/ratnam1510/turborag
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+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: Ruby client for the TurboRAG compressed vector retrieval API
+test_files: []