Files
wifi-densepose/npm/core/platforms/win32-x64-msvc
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
..

ruvector-core-win32-x64-msvc

npm version License: MIT

Windows x64 MSVC native binding for ruvector-core

This package contains the native Node.js binding (.node file) for Windows x64 systems compiled with MSVC. 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: Windows 10 (1809+) or Windows 11, Windows Server 2019+
  • Architecture: x86_64 (64-bit)
  • Node.js: 18.0.0 or higher
  • Visual C++ Runtime: Automatically included with Node.js

Compatibility

This package is compatible with:

  • Windows 10 (version 1809 or later)
  • Windows 11 (all versions)
  • Windows Server 2019 and newer
  • Most Windows development environments

Note: Windows ARM64 is not currently supported.

What's Inside

This package contains:

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

Performance

When running on Windows 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
  • Optimized for Intel/AMD AVX2 SIMD instructions

Building from Source

If you need to rebuild the native module:

Prerequisites

  1. Install Visual Studio 2022 (or 2019) with "Desktop development with C++" workload
  2. Install Rust: https://rustup.rs/
  3. Open "x64 Native Tools Command Prompt for VS 2022"

Build Steps

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

# Build for Windows x64
cd npm\packages\core
npm run build:napi -- --target x86_64-pc-windows-msvc

Troubleshooting

Module Not Found Error

If you see "Cannot find module 'ruvector-core-win32-x64-msvc'":

  1. Verify you're on Windows 64-bit: wmic os get osarchitecture should show "64-bit"
  2. Reinstall with optional dependencies: npm install --include=optional ruvector-core
  3. Check Node.js version: node --version should be 18.0.0 or higher

DLL Loading Issues

If the module fails to load with DLL errors:

  1. Install Visual C++ Redistributable:

  2. Check Windows Updates:

    • Ensure Windows is up to date
    • Some MSVC runtimes come through Windows Update
  3. Verify Node.js Installation:

    • Reinstall Node.js from nodejs.org
    • Use the Windows Installer (.msi) version

Long Path Issues

If you encounter "path too long" errors:

  1. Enable Long Paths in Windows:

    # Run PowerShell as Administrator
    New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled" -Value 1 -PropertyType DWORD -Force
    
  2. Or use shorter paths:

    • Install Node modules closer to drive root (e.g., C:\projects\)

Antivirus False Positives

Some antivirus software may flag native .node files:

  • Add an exception for node_modules\ruvector-core-win32-x64-msvc\
  • Or temporarily disable real-time scanning during npm install

WSL2 (Windows Subsystem for Linux)

If you're using WSL2:

  • Use the Linux packages instead (ruvector-core-linux-x64-gnu)
  • This Windows package is for native Windows Node.js only

Resources

License

MIT License - see LICENSE for details.


Built with ❤️ by the ruv.io team