usearch 2.1.0 → 2.1.2

package/.github/workflows/Dockerfile.libs

@@ -7,7 +7,7 @@ ARG docker_ip
 ARG user_pass
 
 RUN apt-get update && \
-    apt-get install -y --no-install-recommends python3.11 python3-pip cmake g++-12 build-essential libjemalloc-dev golang openssh-client sshpass && \
+    apt-get install -y --no-install-recommends cmake g++-12 build-essential libjemalloc-dev golang openssh-client sshpass && \
     apt-get clean && \
     rm -rf /var/lib/apt/lists/*
 
@@ -23,12 +23,12 @@ RUN if [ "$TARGETPLATFORM" = "linux/amd64" ]; then \
         export arch="arm"; \
     fi && \
     version=$(cat VERSION) && \
-    mkdir -p usearch_"$arch"_"$version"/DEBIAN && \
-    touch usearch_"$arch"_"$version"/DEBIAN/control && \
-    mkdir -p usearch_"$arch"_"$version"/usr/local/lib && \
-    mkdir usearch_"$arch"_"$version"/usr/local/include && \
-    cp c/usearch.h usearch_"$arch"_"$version"/usr/local/include/ && \
-    cp golang/libusearch.a usearch_"$arch"_"$version"/usr/local/lib/ && \
-    echo "Package: usearch\nVersion: $version\nMaintainer: Ashot Vardanian\nArchitecture: "$arch"\nDescription: Faster & Smaller Single-File Search Engine for Vectors & Texts" > usearch_"$arch"_"$version"/DEBIAN/control && \
-    dpkg-deb --build usearch_"$arch"_"$version" && \
-    sshpass -p "$user_pass" scp -o StrictHostKeyChecking=no usearch_"$arch"_"$version".deb "$user_name"@"$docker_ip":/home/$user_name/work/usearch/usearch/
+    mkdir -p usearch_linux_"$arch"_"$version"/DEBIAN && \
+    touch usearch_linux_"$arch"_"$version"/DEBIAN/control && \
+    mkdir -p usearch_linux_"$arch"_"$version"/usr/local/lib && \
+    mkdir usearch_linux_"$arch"_"$version"/usr/local/include && \
+    cp c/usearch.h usearch_linux_"$arch"_"$version"/usr/local/include/ && \
+    cp golang/libusearch.a usearch_linux_"$arch"_"$version"/usr/local/lib/ && \
+    echo "Package: usearch\nVersion: $version\nMaintainer: Ashot Vardanian\nArchitecture: "$arch"\nDescription: Faster & Smaller Single-File Search Engine for Vectors & Texts" > usearch_linux_"$arch"_"$version"/DEBIAN/control && \
+    dpkg-deb --build usearch_linux_"$arch"_"$version" && \
+    sshpass -p "$user_pass" scp -o StrictHostKeyChecking=no usearch_linux_"$arch"_"$version".deb "$user_name"@"$docker_ip":/home/$user_name/work/usearch/usearch/

package/.github/workflows/prerelease.yml

@@ -219,6 +219,33 @@ jobs:
         shell: bash
         working-directory: ${{ github.workspace }}/csharp/
 
+  test_golang:
+    name: Test Golang
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+      with:
+        persist-credentials: false
+        ref: 'main-dev'
+    - run: git submodule update --init --recursive
+
+    - name: Prepare environment
+      run: |
+        sudo apt update && 
+        sudo apt install -y cmake g++-12 build-essential libjemalloc-dev
+          
+    - name: Build library
+      run: |
+        cd golang && make -C ../c libusearch_c.so
+        sudo mv ../c/libusearch_c.so /usr/local/lib/libusearch.a
+        sudo mv ../c/usearch.h /usr/local/include/usearch.h
+
+    - name: Run test
+      run: |
+        cd golang
+        go test -v
+        
+
   build_docker:
     name: Test Docker Image
     runs-on: ubuntu-latest

package/.github/workflows/release.yml

@@ -14,6 +14,7 @@ permissions:
   contents: write
   pages: write
   id-token: write
+  packages: write
 
 jobs:
 
@@ -29,7 +30,7 @@ jobs:
 
 
   rebase:
-    name: Rebase Development Branch
+    name: Rebase Dev. Branch
     needs: versioning
     runs-on: ubuntu-latest
     steps:
@@ -40,66 +41,23 @@ jobs:
 
       - name: Perform rebase
         run: |
+          git fetch origin main
           git checkout main-dev
-          git rebase main
+          git rebase origin/main
           
       - name: Push changes
         uses: CasperWA/push-protected@v2
         with:
-          token: ${{ secrets.SEMANTIC_REBASE_TOKEN }}
+          token: ${{ secrets.SEMANTIC_RELEASE_TOKEN }}
           branch: main-dev
           unprotect_reviews: True
           force: True
 
 
-  publish_hashes:
-    name: Add hashes to release notes
+  create_linux_deb_package:
+    name: Create Debian Package for ${{ matrix.arch }}
     runs-on: ubuntu-latest
     needs: versioning
-    steps:
-    - name: Get last release ID
-      id: last_release
-      run: |
-          response=$(curl -s -H "Authorization: Bearer ${{ secrets.SEMANTIC_RELEASE_TOKEN }}" \
-            "https://api.github.com/repos/${{ github.repository }}/releases/latest")
-          echo "last_release_id=$(echo "$response" | jq -r '.id')" >> $GITHUB_OUTPUT
-
-    - uses: robinraju/release-downloader@v1.8
-      name: Download release assets
-      with:
-        latest: true
-        fileName: "*"
-        out-file-path: "downloads"
-        tarBall: true
-        zipBall: true
-
-    - name: Calculate source hashes
-      id: hashes
-      run: |
-        source_zip_path=$(find $GITHUB_WORKSPACE/downloads -name "*.zip")
-        zip_hash=$(sha256sum "$source_zip_path" | awk '{print $1}')
-        source_tar_path=$(find $GITHUB_WORKSPACE/downloads -name "*.tar.gz" ! -name "docs.tar.gz")
-        tar_hash=$(sha256sum "$source_tar_path" | awk '{print $1}')
-        echo "zip_hash=$zip_hash" >> $GITHUB_OUTPUT
-        echo "tar_hash=$tar_hash" >> $GITHUB_OUTPUT
-          
-    - name: Upload hashes to release
-      uses: irongut/EditRelease@v1.2.0
-      with:
-        token: ${{ secrets.SEMANTIC_RELEASE_TOKEN }}
-        id: ${{ steps.last_release.outputs.last_release_id }}
-        prerelease: false
-        replacebody: false
-        body: |
-            ## Hashes
-            * Source code (zip) : `${{ steps.hashes.outputs.zip_hash }}` 
-            * Source code (tar.gz) : `${{ steps.hashes.outputs.tar_hash }}`
-
-
-  create_deb_packages_linux:
-    name: Create deb package for Linux on ${{ matrix.arch }}
-    needs: versioning
-    runs-on: ubuntu-latest
     strategy:
       matrix:
         arch: ["linux/amd64", "linux/arm64"]
@@ -110,26 +68,26 @@ jobs:
         ref: 'main'
     - run: git submodule update --init --recursive
 
-    - name: Set up QEMU
+    - name: Setup QEMU
       uses: docker/setup-qemu-action@v2
 
-    - name: Set up Docker Buildx
+    - name: Setup Docker
       uses: docker/setup-buildx-action@v2
 
-    - name: Get docker daemon IP
+    - name: Get Docker daemon IP
       id: dockerip
       run: |
         docker_ip=$(ip addr show docker0 | grep -Po 'inet \K[\d.]+') && \
         echo "docker_ip=$docker_ip" >> "$GITHUB_OUTPUT"
-
-    - name: Set new password for runner user
+        
+    - name: Set runner user password
       id: userpass
       run: |
         user_pass="1122"
         echo "runner:$user_pass" | sudo chpasswd
         echo "user_pass=$user_pass" >> "$GITHUB_OUTPUT"
           
-    - name: Build Usearch lib
+    - name: Build library
       run: |
         docker buildx create --use
         docker buildx build \
@@ -139,11 +97,10 @@ jobs:
         --file .github/workflows/Dockerfile.libs \
         --tag unum/ustore-deps:latest \
         --load .
-
     - name: Clear Docker buildx cache
       run: docker buildx prune --all --force
 
-    - name: Upload archive to release Assets
+    - name: Upload archive
       uses: xresloader/upload-to-github-release@v1
       env:
         GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -152,6 +109,165 @@ jobs:
         update_latest_release: true
 
 
+  create_windows_dll_library:
+    name: Create Dll Library for Windows ${{ matrix.arch }}
+    runs-on: windows-latest
+    needs: versioning
+    strategy:
+      matrix:
+        arch: [x64, x86]
+    steps:
+    - uses: actions/checkout@v3
+      with:
+        persist-credentials: false
+        ref: 'main'
+    - run: git submodule update --init --recursive
+    
+    - name: Setup Cmake
+      uses: jwlawson/actions-setup-cmake@v1.13
+    
+    - uses: actions/setup-go@v4
+      with:
+        go-version: '^1.19.0'
+
+    - name: Setup Mingw
+      uses: egor-tensin/setup-mingw@v2
+      with:
+        platform: ${{ matrix.arch }}
+
+    - name: Get version
+      id: set_version
+      shell: bash
+      run: |
+        version=$(cat VERSION)
+        echo "version=$version" >> $GITHUB_OUTPUT
+        
+    - name: Build library
+      run: |
+        cd c/ && g++ -std=c++11 -o libusearch.dll -O3 lib.cpp -I.  -I ../include/  -I ../fp16/include/ -shared && cd ..
+        cp c/libusearch.dll golang/libusearch.dll && cp c/usearch.h golang/usearch.h
+    
+    - name: Golang test
+      run: |
+        cd golang/ && go test -v
+      if: ${{ matrix.arch == 'x64' }}
+
+    - name: Compress library
+      run: |
+        cd golang/
+        tar -cvf usearch_windows_${{ matrix.arch }}_${{ steps.set_version.outputs.version }}.tar .\libusearch.dll .\usearch.h
+
+    - name: Upload archive
+      uses: xresloader/upload-to-github-release@v1
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      with:
+        file: "golang/usearch_windows_${{ matrix.arch }}_${{ steps.set_version.outputs.version }}.tar"
+        update_latest_release: true
+
+
+  create_macos_library:
+    name: Create Library for MacOS ${{ matrix.arch }}
+    runs-on: macOS-latest
+    needs: versioning
+    strategy:
+      matrix:
+        arch: [arm64, x86_64]
+    steps:
+    - uses: actions/checkout@v3
+      with:
+        persist-credentials: false
+        ref: 'main'
+    - run: git submodule update --init --recursive
+    
+    - uses: actions/setup-go@v4
+      with:
+        go-version: '^1.21.0'
+
+    - name: Get version
+      id: version
+      run: |
+        version=$(cat VERSION)
+        echo "version=$version" >> $GITHUB_OUTPUT
+
+    - name: Build library
+      run: |
+        cd c/ && clang++ -std=c++11 -o libusearch.so -O3 lib.cpp -I.  -I ../include/  -I ../fp16/include/ -shared -target ${{ matrix.arch }}-apple-macos11 && cd ..
+        cp c/usearch.h golang/
+        cp c/libusearch.so golang/libusearch.so
+
+    - name: Golang test
+      run: |
+        cd golang/
+        go test -v
+      if: ${{ matrix.arch == 'x86_64' }}
+
+    - name: Compress library
+      run: |
+        cd golang/
+        zip -r usearch_macOS_${{ matrix.arch }}_${{ steps.version.outputs.version }}.zip libusearch.so usearch.h 
+
+    - name: Upload archive
+      uses: xresloader/upload-to-github-release@v1
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      with:
+        file: "golang/*.zip"
+        update_latest_release: true
+
+
+  publish_hashes:
+    name: Add hashes to release notes
+    runs-on: ubuntu-latest
+    needs: [versioning, create_linux_deb_package, create_windows_dll_library, create_macos_library]
+    steps:
+    - name: Get last release ID
+      id: last_release
+      run: |
+          response=$(curl -s -H "Authorization: Bearer ${{ secrets.SEMANTIC_RELEASE_TOKEN }}" \
+            "https://api.github.com/repos/${{ github.repository }}/releases/latest")
+          echo "last_release_id=$(echo "$response" | jq -r '.id')" >> $GITHUB_OUTPUT
+
+    - uses: robinraju/release-downloader@v1.8
+      name: Download release assets
+      with:
+        latest: true
+        fileName: "*"
+        out-file-path: "downloads"
+        tarBall: true
+        zipBall: true
+
+    - name: Calculate source hashes
+      id: hashes
+      run: |
+        i=1
+        cd $GITHUB_WORKSPACE/downloads
+        for asset_name in $(ls); do
+          asset_hash=$(sha256sum $asset_name | awk '{print $1}')
+          echo "asset_name_$i=$asset_name" >> $GITHUB_OUTPUT
+          echo "asset_hash_$i=$asset_hash" >> $GITHUB_OUTPUT
+          i=$((i+1))
+        done
+          
+    - name: Upload hashes to release
+      uses: irongut/EditRelease@v1.2.0
+      with:
+        token: ${{ secrets.SEMANTIC_RELEASE_TOKEN }}
+        id: ${{ steps.last_release.outputs.last_release_id }}
+        prerelease: false
+        replacebody: false
+        body: |
+            ## Hashes
+            * ${{ steps.hashes.outputs.asset_name_1 }} : `${{ steps.hashes.outputs.asset_hash_1 }}`
+            * ${{ steps.hashes.outputs.asset_name_2 }} : `${{ steps.hashes.outputs.asset_hash_2 }}`
+            * ${{ steps.hashes.outputs.asset_name_3 }} : `${{ steps.hashes.outputs.asset_hash_3 }}`
+            * ${{ steps.hashes.outputs.asset_name_4 }} : `${{ steps.hashes.outputs.asset_hash_4 }}`
+            * ${{ steps.hashes.outputs.asset_name_5 }} : `${{ steps.hashes.outputs.asset_hash_5 }}`
+            * ${{ steps.hashes.outputs.asset_name_6 }} : `${{ steps.hashes.outputs.asset_hash_6 }}`
+            * ${{ steps.hashes.outputs.asset_name_7 }} : `${{ steps.hashes.outputs.asset_hash_7 }}`
+            * ${{ steps.hashes.outputs.asset_name_8 }} : `${{ steps.hashes.outputs.asset_hash_8 }}`
+
+
   build_wheels:
     name: Build Wheels for ${{ matrix.os }}
     needs: versioning
@@ -375,11 +491,12 @@ jobs:
     runs-on: ubuntu-latest
     needs: [build_csharp]
     env:
+      SOLUTION: ${{ github.workspace }}/csharp
       USEARCH_LIBS: ${{ github.workspace }}/csharp/lib
-      NUGET_DIR: ${{ github.workspace }}/csharp/packages
+      NUGET_PACKAGES: ${{ github.workspace }}/csharp/packages
       # NUGET_SOURCE: https://apiint.nugettest.org/v3/index.json
       NUGET_SOURCE: https://api.nuget.org/v3/index.json
-      SOLUTION_DIR: ${{ github.workspace }}/csharp
+      GITHUB_PACKAGES_SOURCE: https://nuget.pkg.github.com/${{ github.repository_owner }}/index.json
     steps:
       - uses: actions/checkout@v3
       - run: git submodule update --init --recursive
@@ -398,12 +515,17 @@ jobs:
       - name: Pack project
         run: |
           VERSION_CONTENT=$(< VERSION)
-          dotnet pack "${{ env.SOLUTION_DIR }}" -c Release -p:Version="$VERSION_CONTENT" --output ${{ env.NUGET_DIR }}
+          dotnet pack "${{ env.SOLUTION }}" -c Release -p:Version="$VERSION_CONTENT" --output ${{ env.NUGET_PACKAGES }}
         working-directory: ${{ github.workspace }}
 
-      - name: Publish NuGet packages
-        run: |
-          dotnet nuget push "${{  env.NUGET_DIR }}/*.nupkg" --api-key "${{ secrets.NUGET_API }}" --source "${{ env.NUGET_SOURCE }}"
+      - name: Publish to NuGet
+        run: dotnet nuget push "${{ env.NUGET_PACKAGES }}/*.nupkg" --api-key "${{ secrets.NUGET_API }}" --source "${{ env.NUGET_SOURCE }}" --skip-duplicate
+
+      - name: Prepare publish to GitHub Registry
+        run: dotnet nuget add source --username ${{ github.repository_owner }} --password ${{ secrets.GITHUB_TOKEN }} --store-password-in-clear-text --name github "${{ env.GITHUB_PACKAGES_SOURCE }}"
+
+      - name: Publish to GitHub Registry
+        run: dotnet nuget push "${{ env.NUGET_PACKAGES }}/*.nupkg"  --api-key "${{ secrets.GITHUB_TOKEN }}" --source "github" --skip-duplicate
 
   build_docs:
     name: Build Docs

package/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "usearch"
-version = "2.1.0"
+version = "2.1.2"
 authors = ["Ash Vardanian <1983160+ashvardanian@users.noreply.github.com>"]
 description = "Smaller & Faster Single-File Vector Search Engine from Unum"
 edition = "2021"

package/README.md

@@ -83,7 +83,7 @@ USearch is compact and broadly compatible without sacrificing performance, with
 Base functionality is identical to FAISS, and the interface must be familiar if you have ever investigated Approximate Nearest Neighbors search:
 
 ```py
-$ pip install usearch numpy
+$ pip install usearch
 
 import numpy as np
 from usearch.index import Index

package/conanfile.py

@@ -4,7 +4,7 @@ from conans import ConanFile
 class USearchConan(ConanFile):
 
     name = 'USearch'
-    version = '2.1.0'
+    version = '2.1.2'
     license = 'Apache 2.0'
     url = 'https://github.com/unum-cloud/usearch'
     description = 'Smaller & Faster Single-File Vector Search Engine from Unum'

package/csharp/nuget/nuget-package.props

@@ -15,14 +15,14 @@
 
     <PackageIcon>unum.png</PackageIcon>
     <PackageIconUrl>unum.png</PackageIconUrl>
-    <PackageReadmeFile>NUGET.md</PackageReadmeFile>
+    <PackageReadmeFile>README.md</PackageReadmeFile>
   </PropertyGroup>
 
   <ItemGroup>
     <None Include="$(NativeLibDir)runtimes\**\*.*" Pack="true" PackagePath="runtimes" />
     <None Include="$(RepoRoot)LICENSE" Pack="true" PackagePath=""/>
     <None Include="$(RepoRoot)assets\unum.png" Pack="true" PackagePath=""/>
-    <None Include="$(CSharpDir)nuget\NUGET.md" Pack="true" PackagePath=""/>
+    <None Include="$(RepoRoot)README.md" Pack="true" PackagePath=""/>
   </ItemGroup>
 
   <!-- Package validation https://learn.microsoft.com/en-us/dotnet/fundamentals/package-validation/overview?WT.mc_id=DT-MVP-5003978 -->

package/docs/format.md

@@ -0,0 +1,63 @@
+# USearch Format Specification
+
+> ⚠️ **Note**: The format is expected to change in the 3.0 release to support sparse indexes and offer even faster startup times when `view`-ing large indexes from disk.
+
+## Table of Contents
+
+- [Dense Indexes](#dense-indexes)
+- [Core](#core)
+- [Fragmented Storage](#fragmented-storage)
+
+## Dense Indexes
+
+Dense index files consist of two main parts: [a binary matrix of all vectors](#matrix-blob) and the [index](#index-blob) itself.
+
+### Matrix BLOB
+
+The matrix BLOB is optionally prepended to the index file. It starts with the number of `rows` and `columns`, which can be either 32-bit or 64-bit unsigned integers.
+
+- The number of `rows` corresponds to the number of vectors in the index.
+- The number of `columns` corresponds to the number of bytes in a single vector.
+
+### Index BLOB
+
+The index BLOB is composed of three main sections:
+
+1. **Metadata**: Occupies 64 bytes and contains the following fields:
+    1. 7-byte magic string `usearch` to infer the MIME type of the file.
+    2. 3-byte version number, containing the `major`, `minor`, and `patch` release numbers.
+    3. 1-byte enums for `metric`, `scalar`, `key`, and `compressed_slot` types.
+    4. 8-byte integers for the number of present vectors, number of deleted vectors, and number of dimensions.
+    5. 1-byte flags for multi-vector support.
+
+2. **Levels**: Contains 1-byte integers representing the level each node occupies. This information is used to estimate memory requirements and to enable memory-mapping of the entire file.
+
+3. **Core**: Detailed in the [Core section](#core). This format is consistent across all types of indexes.
+
+## Fragmented Storage
+
+The matrix BLOB can be stored separately and is not required to successfully open the file.
+
+## Core
+
+The core section of the index is serialized as a sequence of nodes, each representing a point in the index. This section immediately follows the `levels` block in the serialized format.
+
+### Header
+
+The core section begins with a header containing the following fields:
+
+- `uint64_t size`: Number of nodes in the index.
+- `uint64_t connectivity`: Maximum number of edges for a node.
+- `uint64_t connectivity_base`: Base connectivity value.
+- `uint64_t max_level`: Maximum level in the multi-level graph.
+- `uint64_t entry_slot`: Entry slot for the graph.
+
+These fields are serialized in a contiguous block of bytes, in the order listed.
+
+### Levels
+
+Following the header, the `levels` block contains a sequence of 1-byte integers. Each integer represents the level of a node in the index. The number of levels is equal to the `size` field in the header.
+
+### Nodes
+
+After the `levels` block, the nodes are serialized. Each node is represented as a contiguous block of bytes. The size and format of these blocks are implementation-specific. Nodes are serialized in the same order as their corresponding levels in the `levels` block.

package/docs/format.rst

@@ -0,0 +1,5 @@
+========================
+Format
+========================
+
+.. mdinclude:: format.md

package/docs/index.rst

@@ -24,6 +24,7 @@ Overview
 
    compilation
    benchmarks
+   format
 
 .. toctree:: 
    :hidden:

package/golang/README.md

@@ -2,14 +2,36 @@
 
 ## Installation
 
+### Linux
+
 Download and install from the Debian package from the latest release.
 Substitute `<release_tag>`, `<arch>`, and `<usearch_version>` with your settings.
 
 ```
-wget https://github.com/unum-cloud/usearch/releases/download/<release_tag>/usearch_<arch>_<usearch_version>.deb
+wget https://github.com/unum-cloud/usearch/releases/download/<release_tag>/usearch_linux_<arch>_<usearch_version>.deb
 dpkg -i usearch_<arch>_<usearch_version>.deb
 ```
 
+### Windows
+
+Run a `winlibinstaller.bat` script from the main repository in the folder where you will run `go run`.
+That will install the USearch library and include in the same folder` where the script was run.
+
+```
+.\usearch\winlibinstaller.bat
+```
+
+### MacOS
+
+Download and unpack a zip archive from the latest release.
+Move the USearch library and the include file to their respective folders.
+```
+wget https://github.com/unum-cloud/usearch/releases/download/<release_tag>/usearch_macOS_<arch>_<usearch_version>.zip
+unzip usearch_macOS_<arch>_<usearch_version>.zip
+sudo mv libusearch.so /usr/local/lib && sudo mv usearch.h /usr/local/include
+
+```
+
 ## Quickstart
 
 1. Create a `go.mod` file:

package/include/usearch/index.hpp

@@ -1272,7 +1272,7 @@ struct dummy_executor_t {
  *  @brief  An example of what a USearch-compatible key-to-key mapping should look like.
  *
  *  This is particularly helpful for "Semantic Joins", where we map entries of one collection
- *  to entries of another. In assymetric setups, where A -> B is needed, but B -> A is not,
+ *  to entries of another. In asymmetric setups, where A -> B is needed, but B -> A is not,
  *  this can be passed to minimize memory usage.
  */
 struct dummy_key_to_key_mapping_t {
@@ -1284,16 +1284,16 @@ struct dummy_key_to_key_mapping_t {
 
 /**
  *  @brief  Checks if the provided object has a dummy type, emulating an interface,
- *          but performaing no real computation.
+ *          but performing no real computation.
  */
 template <typename object_at> static constexpr bool is_dummy() {
     using object_t = typename std::remove_all_extents<object_at>::type;
-    return std::is_same<object_t, dummy_predicate_t>::value || //
-           std::is_same<object_t, dummy_callback_t>::value ||  //
-           std::is_same<object_t, dummy_progress_t>::value ||  //
-           std::is_same<object_t, dummy_prefetch_t>::value ||  //
-           std::is_same<object_t, dummy_executor_t>::value ||  //
-           std::is_same<object_t, dummy_key_to_key_mapping_t>::value;
+    return std::is_same<typename std::decay<object_t>::type, dummy_predicate_t>::value || //
+           std::is_same<typename std::decay<object_t>::type, dummy_callback_t>::value ||  //
+           std::is_same<typename std::decay<object_t>::type, dummy_progress_t>::value ||  //
+           std::is_same<typename std::decay<object_t>::type, dummy_prefetch_t>::value ||  //
+           std::is_same<typename std::decay<object_t>::type, dummy_executor_t>::value ||  //
+           std::is_same<typename std::decay<object_t>::type, dummy_key_to_key_mapping_t>::value;
 }
 
 template <typename, typename at> struct has_reset_gt {
@@ -1513,6 +1513,8 @@ class memory_mapped_file_t {
 #else
         int descriptor = open(path_, O_RDONLY);
 #endif
+        if (descriptor < 0)
+            return result.failed(std::strerror(errno));
 
         // Estimate the file size
         struct stat file_stat;
@@ -2502,7 +2504,7 @@ class index_gt {
     }
 
     /**
-     *  @brief Identifies the closest cluster to the gived ::query. Thread-safe.
+     *  @brief Identifies the closest cluster to the given ::query. Thread-safe.
      *
      *  @param[in] query Content that will be compared against other entries in the index.
      *  @param[in] level The index level to target. Higher means lower resolution.
@@ -3325,7 +3327,7 @@ class index_gt {
         visits.clear();
 
         // Optional prefetching
-        if (!std::is_same<prefetch_at, dummy_prefetch_t>::value)
+        if (!std::is_same<typename std::decay<prefetch_at>::type, dummy_prefetch_t>::value)
             prefetch(citerator_at(closest_slot), citerator_at(closest_slot + 1));
 
         distance_t closest_dist = context.measure(query, citerator_at(closest_slot), metric);
@@ -3337,7 +3339,7 @@ class index_gt {
                 neighbors_ref_t closest_neighbors = neighbors_non_base_(node_at_(closest_slot), level);
 
                 // Optional prefetching
-                if (!std::is_same<prefetch_at, dummy_prefetch_t>::value) {
+                if (!std::is_same<typename std::decay<prefetch_at>::type, dummy_prefetch_t>::value) {
                     candidates_range_t missing_candidates{*this, closest_neighbors, visits};
                     prefetch(missing_candidates.begin(), missing_candidates.end());
                 }
@@ -3379,7 +3381,7 @@ class index_gt {
             return false;
 
         // Optional prefetching
-        if (!std::is_same<prefetch_at, dummy_prefetch_t>::value)
+        if (!std::is_same<typename std::decay<prefetch_at>::type, dummy_prefetch_t>::value)
             prefetch(citerator_at(start_slot), citerator_at(start_slot + 1));
 
         distance_t radius = context.measure(query, citerator_at(start_slot), metric);
@@ -3404,7 +3406,7 @@ class index_gt {
             neighbors_ref_t candidate_neighbors = neighbors_(candidate_ref, level);
 
             // Optional prefetching
-            if (!std::is_same<prefetch_at, dummy_prefetch_t>::value) {
+            if (!std::is_same<typename std::decay<prefetch_at>::type, dummy_prefetch_t>::value) {
                 candidates_range_t missing_candidates{*this, candidate_neighbors, visits};
                 prefetch(missing_candidates.begin(), missing_candidates.end());
             }
@@ -3453,7 +3455,7 @@ class index_gt {
             return false;
 
         // Optional prefetching
-        if (!std::is_same<prefetch_at, dummy_prefetch_t>::value)
+        if (!std::is_same<typename std::decay<prefetch_at>::type, dummy_prefetch_t>::value)
             prefetch(citerator_at(start_slot), citerator_at(start_slot + 1));
 
         distance_t radius = context.measure(query, citerator_at(start_slot), metric);
@@ -3473,7 +3475,7 @@ class index_gt {
             neighbors_ref_t candidate_neighbors = neighbors_base_(node_at_(candidate.slot));
 
             // Optional prefetching
-            if (!std::is_same<prefetch_at, dummy_prefetch_t>::value) {
+            if (!std::is_same<typename std::decay<prefetch_at>::type, dummy_prefetch_t>::value) {
                 candidates_range_t missing_candidates{*this, candidate_neighbors, visits};
                 prefetch(missing_candidates.begin(), missing_candidates.end());
             }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "usearch",
-    "version": "2.1.0",
+    "version": "2.1.2",
     "description": "Smaller & Faster Single-File Vector Search Engine from Unum",
     "author": "Ash Vardanian",
     "license": "Apache 2.0",

package/python/usearch/index.py

@@ -562,12 +562,11 @@ class Index:
         )
 
         self.path = path
-        if path and os.path.exists(path):
-            path = os.fspath(path)
+        if path is not None:
             if view:
-                self._compiled.view(path)
+                self.view(path)
             else:
-                self._compiled.load(path)
+                self.load(path)
 
     @staticmethod
     def metadata(path_or_buffer: PathOrBuffer) -> Optional[dict]:
@@ -919,7 +918,9 @@ class Index:
     def expansion_search(self, v: int):
         self._compiled.expansion_search = v
 
-    def save(self, path_or_buffer: Union[str, os.PathLike, NoneType] = None) -> Optional[bytes]:
+    def save(
+        self, path_or_buffer: Union[str, os.PathLike, NoneType] = None
+    ) -> Optional[bytes]:
         path_or_buffer = path_or_buffer if path_or_buffer else self.path
         if path_or_buffer is None:
             return self._compiled.save_index_to_buffer()
@@ -937,7 +938,9 @@ class Index:
         else:
             self._compiled.load_index_from_path(os.fspath(path_or_buffer))
 
-    def view(self, path_or_buffer: Union[str, os.PathLike, bytes, bytearray, NoneType] = None):
+    def view(
+        self, path_or_buffer: Union[str, os.PathLike, bytes, bytearray, NoneType] = None
+    ):
         path_or_buffer = path_or_buffer if path_or_buffer else self.path
         if path_or_buffer is None:
             raise Exception("Define the source")

package/setup.py

@@ -66,6 +66,7 @@ setup(
     package_dir={"usearch": "python/usearch"},
     description="Smaller & Faster Single-File Vector Search Engine from Unum",
     author="Ash Vardanian",
+    author_email="info@unum.cloud",
     long_description=long_description,
     long_description_content_type="text/markdown",
     license="Apache-2.0",

package/wasmer.toml

@@ -1,6 +1,6 @@
 [package]
 name="unum/usearch"
-version="2.1.0"
+version="2.1.2"
 description="Smaller & Faster Single-File Vector Search Engine from Unum"
 license="Apache-2.0"
 readme="README.md"

package/winlibinstaller.bat

@@ -0,0 +1,42 @@
+@echo off
+
+rem Get latest release tag
+set "repo_owner=unum-cloud"
+set "repo_name=usearch"
+
+rem Get the latest tag without quotes
+for /f "delims=" %%i in ('curl -s https://api.github.com/repos/%repo_owner%/%repo_name%/releases/latest ^| findstr "tag_name"') do (
+    for /f "tokens=2 delims=:, " %%a in ("%%i") do (
+        set "latest_tag=%%~a"
+    )
+)
+
+rem Get Windows architecture
+for /f "tokens=2 delims= " %%a in ('wmic OS get OSArchitecture ^| find "64"') do set "arch=x64"
+if "%arch%"=="" set "arch=x86"
+
+echo Split library version from release version!
+timeout /t 1
+rem Split the first 'v' from the version number.
+for /f "tokens=1 delims=v" %%a in ('echo %latest_tag%') do (
+    set lib_version=%%a
+)
+
+echo Download usearch library archive!
+rem Download the file.
+timeout /t 2
+curl -LO https://github.com/%repo_owner%/%repo_name%/releases/download/%latest_tag%/usearch_windows_%arch%_%lib_version%.tar
+echo Download is complete!
+
+echo Extract archive!
+rem Extract archive.
+timeout /t 1
+tar -xf usearch_windows_%arch%_%lib_version%.tar
+echo Extract is complete!
+
+rem Remove the archive.
+del usearch_windows_%arch%_%lib_version%.tar
+
+echo Extraction complete and downloaded .tar file removed.
+timeout /t 1
+exit /b

package/csharp/nuget/NUGET.md

@@ -1,11 +0,0 @@
-**Cloud.Unum.USearch** is a wrapper for the USearch vector search engine, offering fast searches, multiple metrics, and features like SIMD-optimized metrics.
-
-**Supported metrics**: Euclidean, Angular, Jaccard, Hamming, Haversine, User-Defined Metrics
-
-**Platforms**: Linux, MacOS, Windows
-
-# Getting Started ⚡
-
-- [Quickstart](https://github.com/unum-cloud/usearch/blob/main/csharp/README.md)
-- Join the [Discord community](https://discord.gg/A6wxt6dS9j)
-- Check out the [GitHub repository](https://github.com/unum-cloud/usearch)