zvec 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7550945f04b87934586dac9b5772943e4e3c052f50bf6f5e01d6d181af8f78b0
-  data.tar.gz: ca37a88357401687d9fdd038f2aa4998d979453f4f37524fbdd966e18eb1a282
+  metadata.gz: d6f88eba541a4d535d54a2b8b43f0852ddfaa3c2b58ff41885ba51ae405c8428
+  data.tar.gz: 0d383b42d8961c566f47f8763cdcdb19788b627e5a41087e10779080d5969d97
 SHA512:
-  metadata.gz: 5e60837d9cadf7b6bc9732c89d62a56d49d8b90db1a96221697682b52508707b3ddd06c7130ec1b150c7da04ef75ff3a4f23104384cdeb94fe4fc61fa5c98fa0
-  data.tar.gz: c49d7875bc4e33caa30fb2db6944680550ad8cb1b92c6519e0ad2c20f2452357a411b6ede3853fe3255b3e34f7d765b362d07076769f8c786c649806618ad818
+  metadata.gz: 520389cf9f9394f982e367de3e08ad731c5b188b60efe4c863937742c823384dc05541e890f95d267bcd710dc4263300061978d546856148fd8f4ab1e29c661f
+  data.tar.gz: '08866c1988ec0ed47a040ac9be95b4d15098f31dec925da3e25e62beffb3b828ae51c55ccb7aedd31a2ca7a08b84a537eb10299cf976ecc9045590a722906f33'

data/README.md

@@ -29,36 +29,46 @@
 Ruby bindings for Alibaba's [zvec](https://github.com/alibaba/zvec) C++ vector database library. Store, index, and query high-dimensional vectors alongside scalar metadata — all from Ruby. The native extension uses [Rice](https://github.com/ruby-rice/rice) (v4.11) for C++/Ruby interop and CMake for building. The zvec C++ source is included as a git submodule.
 
 > [!CAUTION]
-> I set `rake install` up to mirror (I hope) the kind of performance that you can expect from a `gem install zvec` which will compile the actual zvec source on the user's machine.  This will take several minutes.  It may not work on all platforms. I'm not sure that it will work at all because there are so many pieces and so many platforms.
+> Without the Homebrew formula, `gem install zvec` compiles the entire zvec C++ dependency tree from source (~10 minutes). Pre-building with Homebrew reduces this to ~10 seconds. The source build may not work on all platforms.
 
 ## Prerequisites
 
 - Ruby >= 3.2.0
 - CMake >= 3.26
 - A C++17 compiler (Clang or GCC)
-- ICU4C: `brew install icu4c@78` (macOS — CMake expects it at `/opt/homebrew/opt/icu4c@78`)
+- ICU4C: `brew install icu4c@78` (macOS)
 
 ## Installation
 
-Add to your Gemfile:
+### Recommended: Pre-build with Homebrew (fast)
 
-```ruby
-gem "zvec"
+Pre-building the zvec C++ library avoids a lengthy source compilation during gem install:
+
+```bash
+brew tap madbomber/zvec https://github.com/MadBomber/zvec-ruby.git
+brew install madbomber/zvec/zvec
+gem install zvec          # ~10 seconds
 ```
 
-Then build the native extension:
+### Alternative: Build from source (slow)
+
+Without Homebrew, the gem fetches and compiles the full C++ dependency tree (~10 minutes):
 
 ```bash
-bundle install
-cd ext && cmake --preset macos-release && cmake --build build/macos-release && cd ..
+gem install zvec
 ```
 
-For development/debug builds:
+### Development (from source checkout)
 
 ```bash
-cd ext && cmake --preset macos-debug && cmake --build build/macos-debug && cd ..
+git clone --recurse-submodules https://github.com/MadBomber/zvec-ruby.git
+cd zvec-ruby
+bundle install
+cd ext && cmake --preset macos-release && cmake --build build/macos-release && cd ..
 ```
 
+For debug builds use the `macos-debug` preset instead.
+
 ## Quick Start
 
 ```ruby

data/ext/CMakeLists.txt

@@ -34,79 +34,105 @@ FetchContent_MakeAvailable(rice)
 list(PREPEND CMAKE_MODULE_PATH "${rice_SOURCE_DIR}")
 find_package(Ruby REQUIRED COMPONENTS Development)
 
-# Disable parts of zvec we don't need (must be set before add_subdirectory)
-set(BUILD_PYTHON_BINDINGS OFF CACHE BOOL "" FORCE)
-set(BUILD_TOOLS OFF CACHE BOOL "" FORCE)
-set(BUILD_TESTING OFF CACHE BOOL "" FORCE)
-set(BENCHMARK_ENABLE_TESTING OFF CACHE BOOL "" FORCE)
-set(BENCHMARK_ENABLE_INSTALL OFF CACHE BOOL "" FORCE)
-
-# --- Locate or fetch zvec C++ source ---
-set(_ZVEC_LOCAL "${CMAKE_CURRENT_SOURCE_DIR}/../vendor/zvec")
-
-if(EXISTS "${_ZVEC_LOCAL}/CMakeLists.txt")
-  # Development: use the git submodule
-  message(STATUS "Using local zvec from ${_ZVEC_LOCAL}")
-  set(ZVEC_ROOT "${_ZVEC_LOCAL}")
+# ============================================================================
+# Three-tier zvec resolution:
+#   1. Pre-installed library (e.g., brew install zvec) — fast path
+#   2. Local git submodule at vendor/zvec — development path
+#   3. FetchContent from GitHub — fallback for gem install without Homebrew
+# ============================================================================
+
+# --- Strategy 1: Find pre-installed zvec (e.g., from Homebrew) ---
+find_library(ZVEC_LIBRARY zvec
+  HINTS /opt/homebrew/opt/zvec/lib
+        /usr/local/opt/zvec/lib
+        ENV ZVEC_DIR
+)
+find_path(ZVEC_INCLUDE_DIR zvec/db/collection.h
+  HINTS /opt/homebrew/opt/zvec/include
+        /usr/local/opt/zvec/include
+        ENV ZVEC_DIR
+)
+
+if(ZVEC_LIBRARY AND ZVEC_INCLUDE_DIR)
+  message(STATUS "Found pre-installed zvec: ${ZVEC_LIBRARY}")
+  message(STATUS "  includes: ${ZVEC_INCLUDE_DIR}")
+  set(ZVEC_PREBUILT TRUE)
 else()
-  # Gem install: fetch zvec from GitHub (download only, add_subdirectory below)
-  message(STATUS "vendor/zvec not found — fetching from GitHub")
-  FetchContent_Declare(
-    zvec_src
-    GIT_REPOSITORY https://github.com/alibaba/zvec.git
-    GIT_TAG        232803611ea91abc96904a92c878c4c67ddf73e6
-    GIT_SHALLOW    FALSE
-    GIT_SUBMODULES_RECURSE TRUE
-  )
-  FetchContent_GetProperties(zvec_src)
-  if(NOT zvec_src_POPULATED)
-    FetchContent_Populate(zvec_src)
+  set(ZVEC_PREBUILT FALSE)
+
+  # Disable parts of zvec we don't need (must be set before add_subdirectory)
+  set(BUILD_PYTHON_BINDINGS OFF CACHE BOOL "" FORCE)
+  set(BUILD_TOOLS OFF CACHE BOOL "" FORCE)
+  set(BUILD_TESTING OFF CACHE BOOL "" FORCE)
+  set(BENCHMARK_ENABLE_TESTING OFF CACHE BOOL "" FORCE)
+  set(BENCHMARK_ENABLE_INSTALL OFF CACHE BOOL "" FORCE)
+
+  # --- Strategy 2: Local submodule (development) ---
+  set(_ZVEC_LOCAL "${CMAKE_CURRENT_SOURCE_DIR}/../vendor/zvec")
+
+  if(EXISTS "${_ZVEC_LOCAL}/CMakeLists.txt")
+    message(STATUS "Using local zvec from ${_ZVEC_LOCAL}")
+    set(ZVEC_ROOT "${_ZVEC_LOCAL}")
+  else()
+    # --- Strategy 3: FetchContent from GitHub ---
+    message(STATUS "vendor/zvec not found — fetching from GitHub")
+    FetchContent_Declare(
+      zvec_src
+      GIT_REPOSITORY https://github.com/alibaba/zvec.git
+      GIT_TAG        232803611ea91abc96904a92c878c4c67ddf73e6
+      GIT_SHALLOW    FALSE
+      GIT_SUBMODULES_RECURSE TRUE
+    )
+    FetchContent_GetProperties(zvec_src)
+    if(NOT zvec_src_POPULATED)
+      FetchContent_Populate(zvec_src)
+    endif()
+    set(ZVEC_ROOT "${zvec_src_SOURCE_DIR}")
+
+    # zvec's subdirectory CMakeLists expect cmake/ relative to CMAKE_SOURCE_DIR
+    # (in development, ext/cmake is a symlink to ../vendor/zvec/cmake)
+    if(NOT EXISTS "${CMAKE_SOURCE_DIR}/cmake/bazel.cmake")
+      file(COPY "${ZVEC_ROOT}/cmake/" DESTINATION "${CMAKE_SOURCE_DIR}/cmake/")
+    endif()
   endif()
-  set(ZVEC_ROOT "${zvec_src_SOURCE_DIR}")
 
-  # zvec's subdirectory CMakeLists expect cmake/ relative to CMAKE_SOURCE_DIR
-  # (in development, ext/cmake is a symlink to ../vendor/zvec/cmake)
-  if(NOT EXISTS "${CMAKE_SOURCE_DIR}/cmake/bazel.cmake")
-    file(COPY "${ZVEC_ROOT}/cmake/" DESTINATION "${CMAKE_SOURCE_DIR}/cmake/")
-  endif()
-endif()
+  # zvec uses PROJECT_ROOT_DIR internally
+  set(PROJECT_ROOT_DIR "${ZVEC_ROOT}" CACHE PATH "" FORCE)
 
-# zvec uses PROJECT_ROOT_DIR internally
-set(PROJECT_ROOT_DIR "${ZVEC_ROOT}" CACHE PATH "" FORCE)
+  # Forward CMAKE_PREFIX_PATH to Arrow's ExternalProject_Add via CMAKE_CACHE_ARGS
+  # (Arrow's CONFIGURE_COMMAND interpolates ${CMAKE_CACHE_ARGS} but it's unset by default)
+  if(CMAKE_PREFIX_PATH)
+    set(CMAKE_CACHE_ARGS "-DCMAKE_PREFIX_PATH=${CMAKE_PREFIX_PATH}")
+  endif()
 
-# Forward CMAKE_PREFIX_PATH to Arrow's ExternalProject_Add via CMAKE_CACHE_ARGS
-# (Arrow's CONFIGURE_COMMAND interpolates ${CMAKE_CACHE_ARGS} but it's unset by default)
-if(CMAKE_PREFIX_PATH)
-  set(CMAKE_CACHE_ARGS "-DCMAKE_PREFIX_PATH=${CMAKE_PREFIX_PATH}")
-endif()
+  # --- Fix antlr4 CMakeLists.txt for CMake 4.x compatibility ---
+  # zvec's own patch (antlr4.patch) runs first via apply_patch_once(), but it doesn't
+  # fix the OLD policies that CMake 4.x removed. We apply additional fixups here.
+  set(_antlr4_cmake "${ZVEC_ROOT}/thirdparty/antlr/antlr4/runtime/Cpp/CMakeLists.txt")
+  set(_antlr4_cmake4_mark "${ZVEC_ROOT}/thirdparty/antlr/antlr4/.cmake4_compat_patched")
+  if(NOT EXISTS "${_antlr4_cmake4_mark}" AND EXISTS "${_antlr4_cmake}")
+    file(READ "${_antlr4_cmake}" _antlr4_content)
+    # Fix cmake_minimum_required to 3.5
+    string(REPLACE "cmake_minimum_required (VERSION 2.8)" "cmake_minimum_required (VERSION 3.5)" _antlr4_content "${_antlr4_content}")
+    # Remove OLD policy settings (CMake 4.x removed these)
+    string(REPLACE "  CMAKE_POLICY(SET CMP0054 OLD)\n  CMAKE_POLICY(SET CMP0045 OLD)\n  CMAKE_POLICY(SET CMP0042 OLD)\n" "" _antlr4_content "${_antlr4_content}")
+    string(REPLACE "  CMAKE_POLICY(SET CMP0059 OLD)\n  CMAKE_POLICY(SET CMP0054 OLD)\n" "" _antlr4_content "${_antlr4_content}")
+    # Fix old-style endif() with arguments
+    string(REPLACE "endif(NOT CMAKE_BUILD_TYPE)" "endif()" _antlr4_content "${_antlr4_content}")
+    string(REPLACE "endif(NOT WITH_DEMO)" "endif()" _antlr4_content "${_antlr4_content}")
+    string(REPLACE "endif(WITH_DEMO)" "endif()" _antlr4_content "${_antlr4_content}")
+    string(REPLACE "endif(WIN32)" "endif()" _antlr4_content "${_antlr4_content}")
+    string(REPLACE "if(NOT ANTLR4_CMAKE_DIR)" "if(NOT DEFINED ANTLR4_CMAKE_DIR OR NOT ANTLR4_CMAKE_DIR)" _antlr4_content "${_antlr4_content}")
+    string(REPLACE "endif(NOT ANTLR4_CMAKE_DIR)" "endif()" _antlr4_content "${_antlr4_content}")
+    string(REPLACE "endif(ANTLR4_INSTALL)" "endif()" _antlr4_content "${_antlr4_content}")
+    file(WRITE "${_antlr4_cmake}" "${_antlr4_content}")
+    file(WRITE "${_antlr4_cmake4_mark}" "patched")
+    message(STATUS "Applied CMake 4.x compatibility fixes to antlr4")
+  endif()
 
-# --- Fix antlr4 CMakeLists.txt for CMake 4.x compatibility ---
-# zvec's own patch (antlr4.patch) runs first via apply_patch_once(), but it doesn't
-# fix the OLD policies that CMake 4.x removed. We apply additional fixups here.
-set(_antlr4_cmake "${ZVEC_ROOT}/thirdparty/antlr/antlr4/runtime/Cpp/CMakeLists.txt")
-set(_antlr4_cmake4_mark "${ZVEC_ROOT}/thirdparty/antlr/antlr4/.cmake4_compat_patched")
-if(NOT EXISTS "${_antlr4_cmake4_mark}" AND EXISTS "${_antlr4_cmake}")
-  file(READ "${_antlr4_cmake}" _antlr4_content)
-  # Fix cmake_minimum_required to 3.5
-  string(REPLACE "cmake_minimum_required (VERSION 2.8)" "cmake_minimum_required (VERSION 3.5)" _antlr4_content "${_antlr4_content}")
-  # Remove OLD policy settings (CMake 4.x removed these)
-  string(REPLACE "  CMAKE_POLICY(SET CMP0054 OLD)\n  CMAKE_POLICY(SET CMP0045 OLD)\n  CMAKE_POLICY(SET CMP0042 OLD)\n" "" _antlr4_content "${_antlr4_content}")
-  string(REPLACE "  CMAKE_POLICY(SET CMP0059 OLD)\n  CMAKE_POLICY(SET CMP0054 OLD)\n" "" _antlr4_content "${_antlr4_content}")
-  # Fix old-style endif() with arguments
-  string(REPLACE "endif(NOT CMAKE_BUILD_TYPE)" "endif()" _antlr4_content "${_antlr4_content}")
-  string(REPLACE "endif(NOT WITH_DEMO)" "endif()" _antlr4_content "${_antlr4_content}")
-  string(REPLACE "endif(WITH_DEMO)" "endif()" _antlr4_content "${_antlr4_content}")
-  string(REPLACE "endif(WIN32)" "endif()" _antlr4_content "${_antlr4_content}")
-  string(REPLACE "if(NOT ANTLR4_CMAKE_DIR)" "if(NOT DEFINED ANTLR4_CMAKE_DIR OR NOT ANTLR4_CMAKE_DIR)" _antlr4_content "${_antlr4_content}")
-  string(REPLACE "endif(NOT ANTLR4_CMAKE_DIR)" "endif()" _antlr4_content "${_antlr4_content}")
-  string(REPLACE "endif(ANTLR4_INSTALL)" "endif()" _antlr4_content "${_antlr4_content}")
-  file(WRITE "${_antlr4_cmake}" "${_antlr4_content}")
-  file(WRITE "${_antlr4_cmake4_mark}" "patched")
-  message(STATUS "Applied CMake 4.x compatibility fixes to antlr4")
+  add_subdirectory("${ZVEC_ROOT}" "${CMAKE_CURRENT_BINARY_DIR}/zvec" EXCLUDE_FROM_ALL)
 endif()
 
-add_subdirectory("${ZVEC_ROOT}" "${CMAKE_CURRENT_BINARY_DIR}/zvec" EXCLUDE_FROM_ALL)
-
 # --- Ruby extension module ---
 add_library(zvec_ext MODULE
   zvec/zvec_ext.cpp
@@ -119,38 +145,48 @@ add_library(zvec_ext MODULE
   zvec/zvec_config.cpp
 )
 
-target_include_directories(zvec_ext PRIVATE
-  "${rice_SOURCE_DIR}/include"
-  "${ZVEC_ROOT}/src/include"
-  "${ZVEC_ROOT}/src"
-)
-
 # Link Rice (header-only) and Ruby
 target_link_libraries(zvec_ext PRIVATE Rice::Rice)
 target_link_libraries(zvec_ext PRIVATE Ruby::Module)
 
-# Algorithm libraries that need force-loading for self-registration
-set(ZVEC_ALGO_LIBS
-  core_knn_flat_static
-  core_knn_flat_sparse_static
-  core_knn_hnsw_static
-  core_knn_hnsw_sparse_static
-  core_knn_ivf_static
-  core_knn_cluster_static
-  core_mix_reducer_static
-  core_metric_static
-  core_utility_static
-  core_quantizer_static
-)
+if(ZVEC_PREBUILT)
+  # --- Fast path: link against pre-installed fat static archive ---
+  target_include_directories(zvec_ext PRIVATE
+    "${rice_SOURCE_DIR}/include"
+    "${ZVEC_INCLUDE_DIR}"
+  )
+  target_link_libraries(zvec_ext PRIVATE -Wl,-force_load,${ZVEC_LIBRARY})
+else()
+  # --- Source build: link against individual zvec targets ---
+  target_include_directories(zvec_ext PRIVATE
+    "${rice_SOURCE_DIR}/include"
+    "${ZVEC_ROOT}/src/include"
+    "${ZVEC_ROOT}/src"
+  )
+
+  # Algorithm libraries that need force-loading for self-registration
+  set(ZVEC_ALGO_LIBS
+    core_knn_flat_static
+    core_knn_flat_sparse_static
+    core_knn_hnsw_static
+    core_knn_hnsw_sparse_static
+    core_knn_ivf_static
+    core_knn_cluster_static
+    core_mix_reducer_static
+    core_metric_static
+    core_utility_static
+    core_quantizer_static
+  )
 
-# Explicit dependency so EXCLUDE_FROM_ALL targets get built
-add_dependencies(zvec_ext ${ZVEC_ALGO_LIBS} zvec_db)
+  # Explicit dependency so EXCLUDE_FROM_ALL targets get built
+  add_dependencies(zvec_ext ${ZVEC_ALGO_LIBS} zvec_db)
 
-# Force-link zvec algorithm libraries (macOS) — required for self-registering algorithms
-foreach(lib ${ZVEC_ALGO_LIBS})
-  target_link_libraries(zvec_ext PRIVATE -Wl,-force_load,$<TARGET_FILE:${lib}>)
-endforeach()
-target_link_libraries(zvec_ext PRIVATE zvec_db)
+  # Force-link zvec algorithm libraries (macOS) — required for self-registering algorithms
+  foreach(lib ${ZVEC_ALGO_LIBS})
+    target_link_libraries(zvec_ext PRIVATE -Wl,-force_load,$<TARGET_FILE:${lib}>)
+  endforeach()
+  target_link_libraries(zvec_ext PRIVATE zvec_db)
+endif()
 
 # Output directory: use CMAKE_LIBRARY_OUTPUT_DIRECTORY if set by RubyGems,
 # otherwise default to the local lib/ directory (development builds)

data/ext/build/macos-debug/CMakeCache.txt

@@ -22,7 +22,7 @@ BENCHMARK_ENABLE_INSTALL:BOOL=OFF
 BENCHMARK_ENABLE_TESTING:BOOL=OFF
 
 //the time we first built rocksdb
-BUILD_DATE:STRING=2026-02-27 05:19:46
+BUILD_DATE:STRING=2026-02-27 07:18:37
 
 //Builds the googlemock subproject
 BUILD_GMOCK:BOOL=ON
@@ -819,6 +819,12 @@ ZLIB_LIBRARY_DEBUG:FILEPATH=ZLIB_LIBRARY_DEBUG-NOTFOUND
 //Path to a library.
 ZLIB_LIBRARY_RELEASE:FILEPATH=/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/usr/lib/libz.tbd
 
+//Path to a file.
+ZVEC_INCLUDE_DIR:PATH=ZVEC_INCLUDE_DIR-NOTFOUND
+
+//Path to a library.
+ZVEC_LIBRARY:FILEPATH=ZVEC_LIBRARY-NOTFOUND
+
 //Ruby extensions extension
 _Ruby_DLEXT:STRING=bundle
 

data/lib/zvec/collection.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Zvec
   module CollectionConvenience
     # Convenience: build a VectorQuery and execute it
@@ -22,10 +24,8 @@ module Zvec
   # Block-form open: yields the collection and flushes on block exit
   def self.open_collection(path, options: nil)
     col = Collection.open(path, options)
-    begin
-      yield col
-    ensure
-      col.flush
-    end
+    yield col
+  ensure
+    col&.flush
   end
 end

data/lib/zvec/doc.rb

@@ -1,6 +1,10 @@
+# frozen_string_literal: true
+
 module Zvec
   class Doc
-    # Convert doc fields to a Ruby Hash using a CollectionSchema for type dispatch
+    # Convert doc fields to a Ruby Hash. The schema parameter is required because
+    # the C++ layer stores fields as type-erased values — the FieldSchema's data_type
+    # selects the correct deserialization path (get_field dispatches on it).
     def to_h(schema)
       result = {"pk" => pk, "score" => score}
       field_names.each do |name|

data/lib/zvec/version.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Zvec
-  VERSION = "0.0.1"
+  VERSION = "0.0.2"
 end

data/lib/zvec.rb

@@ -1,14 +1,25 @@
+# frozen_string_literal: true
+
 require_relative "zvec/version"
 require "zvec_ext"
 require_relative "zvec/collection"
 require_relative "zvec/doc"
 
-# Rice wraps shared_ptr<Collection> as Std::SharedPtr<zvec::Collection>,
-# which delegates C++ methods via method_missing. Ruby convenience methods
-# must be included into this wrapper class, not Zvec::Collection itself.
-# We discover the wrapper class by checking known Std:: classes.
-ObjectSpace.each_object(Class) do |klass|
-  if klass.name&.start_with?("Std::SharedPtr") && klass.name&.include?("Collection")
-    klass.include(Zvec::CollectionConvenience)
+module Zvec
+  # Rice wraps shared_ptr<Collection> as Std::SharedPtr<zvec::Collection>,
+  # a proxy class that delegates C++ methods via method_missing. Ruby
+  # convenience methods must be included into this wrapper class, not
+  # Zvec::Collection itself. We cannot use const_get because the wrapper
+  # class name contains C++ mangled type parameters (e.g. angle brackets).
+  def self.patch_shared_ptr_wrapper!
+    ObjectSpace.each_object(Class) do |klass|
+      if klass.name&.start_with?("Std::SharedPtr") && klass.name&.include?("Collection")
+        klass.include(Zvec::CollectionConvenience)
+        return klass
+      end
+    end
+    nil
   end
 end
+
+Zvec.patch_shared_ptr_wrapper!

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: zvec
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors:
 - Dewayne VanHoozer
@@ -38539,6 +38539,12 @@ metadata:
   homepage_uri: https://github.com/MadBomber/zvec
   source_code_uri: https://github.com/MadBomber/zvec
   changelog_uri: https://github.com/MadBomber/zvec/blob/main/CHANGELOG.md
+post_install_message: |
+  zvec installed successfully!
+
+  Tip: For faster future installs, pre-build the C++ library with Homebrew:
+    brew tap madbomber/zvec https://github.com/MadBomber/zvec-ruby.git
+    brew install madbomber/zvec/zvec
 rdoc_options: []
 require_paths:
 - lib
@@ -38546,14 +38552,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.2.0
+      version: '4.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.6
+rubygems_version: 4.0.7
 specification_version: 4
 summary: EXPERIMENTAL - DO NOT INSTALL - Ruby bindings for Alibaba zvec vector database
 test_files: []