Files

ruv d803bfe2b1 Squashed 'vendor/ruvector/' content from commit b64c2172

git-subtree-dir: vendor/ruvector
git-subtree-split: b64c21726f2bb37286d9ee36a7869fef60cc6900

2026-02-28 14:39:40 -05:00

3.6 KiB

Raw Blame History

ruvector-core-linux-x64-gnu

Linux x64 GNU native binding for ruvector-core

This package contains the native Node.js binding (.node file) for Linux x64 systems with GNU libc. It is automatically installed as an optional dependency when you install ruvector-core on a compatible system.

🌐 Visit ruv.io for more AI infrastructure tools

Installation

You should not install this package directly. Instead, install the main package:

npm install ruvector-core

The correct platform-specific package will be automatically installed based on your system.

System Requirements

Operating System: Linux (GNU libc)
Architecture: x86_64 (x64)
Node.js: 18.0.0 or higher
libc: GNU C Library (glibc)

Compatibility

This package is compatible with:

Ubuntu 18.04+ (all versions)
Debian 10+ (Buster and later)
CentOS 7+ / RHEL 7+
Fedora (all supported versions)
Amazon Linux 2+
Most Linux distributions using glibc

What's Inside

This package contains:

ruvector.node - Native binary module (4.3 MB) compiled from Rust
index.js - Module loader with error handling
Full HNSW indexing implementation
SIMD-optimized vector operations
Multi-threaded async operations via Tokio

Performance

When running on Linux x64 systems, you can expect:

50,000+ vector inserts per second
10,000+ searches per second (k=10)
~50 bytes memory per 128-dim vector
Sub-millisecond latency for most operations

Building from Source

If you need to rebuild the native module:

# Clone the repository
git clone https://github.com/ruvnet/ruvector.git
cd ruvector

# Install Rust toolchain
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Build for Linux x64
cd npm/packages/core
npm run build:napi -- --target x86_64-unknown-linux-gnu

Troubleshooting

Module Not Found Error

If you see "Cannot find module 'ruvector-core-linux-x64-gnu'":

Verify you're on a Linux x64 system: uname -m should output x86_64
Reinstall with optional dependencies: npm install --include=optional ruvector-core
Check Node.js version: node --version should be 18.0.0 or higher

Binary Compatibility Issues

If the module fails to load:

Ensure you have glibc installed: ldd --version
The binary requires glibc 2.17+ (CentOS 7+) or 2.27+ (Ubuntu 18.04+)
For Alpine Linux or musl-based systems, this package will not work (use a glibc-based distro)

ruvector-core - Main package (install this)
ruvector-core-linux-arm64-gnu - Linux ARM64
ruvector-core-darwin-x64 - macOS Intel
ruvector-core-darwin-arm64 - macOS Apple Silicon
ruvector-core-win32-x64-msvc - Windows x64

Resources

License

MIT License - see LICENSE for details.

Built with ❤️ by the ruv.io team

3.6 KiB Raw Blame History