usearch 2.8.3 → 2.8.4

package/simsimd/.github/workflows/prerelease.yml

@@ -1,89 +0,0 @@
-name: Pre-Release
-
-on:
-  push:
-    branches: ["main-dev"]
-  pull_request:
-    branches: ["main-dev"]
-
-env:
-  BUILD_TYPE: Release
-  GH_TOKEN: ${{ secrets.SEMANTIC_RELEASE_TOKEN }}
-  PYTHONUTF8: 1
-
-# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
-permissions:
-  contents: read
-
-jobs:
-  test_python:
-    name: Test Python ${{ matrix.python-version }} on ${{ matrix.architecture }} ${{ matrix.os }}
-    runs-on: ${{ matrix.os }}
-    strategy:
-      fail-fast: false
-      matrix:
-        os: [ubuntu-22.04, macOS-11, windows-2022]
-        python-version: ["3.12", "3.8"]
-        architecture: [x64, arm64]
-
-    steps:
-      - uses: actions/checkout@v3
-      - run: git submodule update --init --recursive
-      - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v4
-        with:
-          python-version: ${{ matrix.python-version }}
-
-      - name: Install dependencies
-        run: |
-          python -m pip install --no-cache-dir --upgrade pip
-          pip install --no-cache-dir pytest numpy scipy py-cpuinfo pytest-repeat
-          python -c "from cpuinfo import get_cpu_info; print(get_cpu_info())"
-
-      - name: Build locally on Ubuntu
-        run: |
-          sudo apt-get update
-          sudo apt-get install gcc-12 -y
-          sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-12 12
-          sudo update-alternatives --config gcc
-          gcc --version
-          python -m pip install .
-        if: ${{ matrix.os == 'ubuntu-22.04' }}
-
-      - name: Build locally on other OS
-        run: python -m pip install .
-        if: ${{ matrix.os != 'ubuntu-22.04' }}
-
-      - name: Test with PyTest
-        run: |
-          python -c "import simsimd; print(simsimd.get_capabilities())"
-          pytest python/test.py -s -x -v
-
-  test_javascript:
-    name: Test JavaScript
-    runs-on: ubuntu-22.04
-    env:
-      CC: gcc-12
-      CXX: g++-12
-
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          ref: "main"
-      - run: git submodule update --init --recursive
-
-      - name: Update compilers
-        run: |
-          sudo apt update
-          sudo apt install -y cmake build-essential libjemalloc-dev libomp-dev gcc-12 g++-12
-
-      - name: Set up Node.js
-        uses: actions/setup-node@v3
-        with:
-          node-version: 18
-
-      - name: Build and Test
-        run: |
-          npm install
-          npm ci
-          npm test

package/simsimd/.github/workflows/release.yml

@@ -1,141 +0,0 @@
-name: Release
-
-on:
-  push:
-    branches: ["main"]
-
-env:
-  BUILD_TYPE: Release
-  GH_TOKEN: ${{ secrets.SEMANTIC_RELEASE_TOKEN }}
-  PYTHONUTF8: 1
-
-# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
-permissions:
-  contents: write
-  pages: write
-  id-token: write
-
-jobs:
-  versioning:
-    name: Semantic Release
-    runs-on: ubuntu-22.04
-    steps:
-      - uses: actions/checkout@v3
-        with:
-          persist-credentials: false
-      - uses: actions/setup-node@v3
-      - run: npm install --save-dev --prefix ./package-ci @semantic-release/exec @semantic-release/git conventional-changelog-eslint semantic-release && npx --prefix ./package-ci semantic-release
-
-  rebase:
-    name: Rebase Dev. Branch
-    needs: versioning
-    runs-on: ubuntu-22.04
-    steps:
-      - name: Checkout the latest code
-        uses: actions/checkout@v3
-        with:
-          fetch-depth: 0
-
-      - name: Perform rebase
-        run: |
-          git fetch origin main
-          git checkout main-dev
-          git rebase origin/main
-
-      - name: Push changes
-        uses: CasperWA/push-protected@v2
-        with:
-          token: ${{ secrets.SEMANTIC_REBASE_TOKEN }}
-          branch: main-dev
-          unprotect_reviews: True
-          force: True
-
-  build_wheels:
-    name: Build Wheels for ${{ matrix.os }}
-    runs-on: ${{ matrix.os }}
-    needs: versioning
-    strategy:
-      fail-fast: false
-      matrix:
-        os: [ubuntu-22.04, macOS-11, windows-2022]
-    steps:
-      - uses: actions/checkout@v3
-        with:
-          ref: "main"
-      - uses: actions/setup-python@v3
-
-      - name: Setup Docker
-        if: matrix.os == 'ubuntu-22.04'
-        uses: docker-practice/actions-setup-docker@master
-
-      - name: Setup QEMU
-        if: matrix.os == 'ubuntu-22.04'
-        uses: docker/setup-qemu-action@v2.1.0
-
-      - name: Install CIBuildWheel
-        run: python -m pip install --no-cache-dir cibuildwheel
-
-      - name: Build wheels
-        run: python -m cibuildwheel
-
-      - uses: actions/upload-artifact@v3
-        with:
-          path: ./wheelhouse/*.whl
-
-  publish_python:
-    name: Publish Python
-    needs: build_wheels
-    runs-on: ubuntu-22.04
-    environment:
-      name: pypi
-      url: https://pypi.org/p/simsimd
-    permissions:
-      id-token: write
-
-    steps:
-      - name: Download artifacts
-        uses: actions/download-artifact@v3.0.2
-        with:
-          path: ./dist/
-
-      - name: Publish to PyPi
-        uses: pypa/gh-action-pypi-publish@release/v1
-        with:
-          packages-dir: ./dist/artifact
-          verbose: true
-          print-hash: true
-
-  publish_javascript:
-    name: Publish JavaScript
-    needs: versioning
-    runs-on: ubuntu-22.04
-    env:
-      CC: gcc-12
-      CXX: g++-12
-
-    steps:
-      - uses: actions/checkout@v3
-        with:
-          ref: "main"
-      - run: git submodule update --init --recursive
-
-      - name: Update compilers
-        run: |
-          sudo apt update
-          sudo apt install -y cmake build-essential libjemalloc-dev libomp-dev gcc-12 g++-12
-
-      - name: Set up Node.js
-        uses: actions/setup-node@v3
-        with:
-          node-version: 18
-
-      - name: Build and Test
-        run: |
-          npm install
-          npm ci
-          npm test
-
-      - name: Publish
-        uses: JS-DevTools/npm-publish@v2
-        with:
-          token: ${{ secrets.NPM_TOKEN }}

package/simsimd/.github/workflows/update_version.sh

@@ -1,5 +0,0 @@
-#!/bin/sh
-
-echo $1 > VERSION && \
-    sed -i "s/\"version\": \".*\"/\"version\": \"$1\"/" package.json && \
-    sed -i "s/\"__version__\", \".*\"/\"__version__\", \"$1\"/" python/lib.c

package/simsimd/.vscode/launch.json

@@ -1,53 +0,0 @@
-{
-    // Use IntelliSense to learn about possible attributes.
-    // Hover to view descriptions of existing attributes.
-    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
-    "version": "0.2.0",
-    "configurations": [
-        {
-            "name": "Debug Benchmark",
-            "type": "cppdbg",
-            "request": "launch",
-            "program": "${workspaceFolder}/build_debug/simsimd_bench",
-            "cwd": "${workspaceFolder}",
-            "args": [
-                "--benchmark_filter=i8_cos"
-            ],
-            "environment": [
-                {
-                    "name": "ASAN_OPTIONS",
-                    "value": "detect_leaks=0:atexit=1:strict_init_order=1:strict_string_checks=1"
-                }
-            ],
-            "stopAtEntry": false,
-            "preLaunchTask": "Build Benchmark: Debug",
-            "linux": {
-                "MIMode": "gdb",
-            },
-            "osx": {
-                "MIMode": "lldb"
-            }
-        },
-        {
-            "name": "Debug Test",
-            "type": "cppdbg",
-            "request": "launch",
-            "program": "${workspaceFolder}/build/test",
-            "cwd": "${workspaceFolder}",
-            "environment": [
-                {
-                    "name": "ASAN_OPTIONS",
-                    "value": "detect_leaks=0:atexit=1:strict_init_order=1:strict_string_checks=1"
-                }
-            ],
-            "stopAtEntry": false,
-            "preLaunchTask": "Build Test: Debug",
-            "linux": {
-                "MIMode": "gdb"
-            },
-            "osx": {
-                "MIMode": "lldb"
-            }
-        }
-    ]
-}

package/simsimd/.vscode/settings.json

@@ -1,114 +0,0 @@
-{
-    "files.associations": {
-        "array": "cpp",
-        "string_view": "cpp",
-        "random": "cpp",
-        "atomic": "cpp",
-        "bit": "cpp",
-        "*.tcc": "cpp",
-        "bitset": "cpp",
-        "cctype": "cpp",
-        "chrono": "cpp",
-        "cinttypes": "cpp",
-        "clocale": "cpp",
-        "cmath": "cpp",
-        "codecvt": "cpp",
-        "compare": "cpp",
-        "concepts": "cpp",
-        "condition_variable": "cpp",
-        "cstdarg": "cpp",
-        "cstddef": "cpp",
-        "cstdint": "cpp",
-        "cstdio": "cpp",
-        "cstdlib": "cpp",
-        "cstring": "cpp",
-        "ctime": "cpp",
-        "cwchar": "cpp",
-        "cwctype": "cpp",
-        "deque": "cpp",
-        "list": "cpp",
-        "map": "cpp",
-        "set": "cpp",
-        "string": "cpp",
-        "unordered_map": "cpp",
-        "vector": "cpp",
-        "exception": "cpp",
-        "algorithm": "cpp",
-        "functional": "cpp",
-        "iterator": "cpp",
-        "memory": "cpp",
-        "memory_resource": "cpp",
-        "numeric": "cpp",
-        "ratio": "cpp",
-        "regex": "cpp",
-        "system_error": "cpp",
-        "tuple": "cpp",
-        "type_traits": "cpp",
-        "utility": "cpp",
-        "fstream": "cpp",
-        "initializer_list": "cpp",
-        "iomanip": "cpp",
-        "iosfwd": "cpp",
-        "iostream": "cpp",
-        "istream": "cpp",
-        "limits": "cpp",
-        "mutex": "cpp",
-        "new": "cpp",
-        "numbers": "cpp",
-        "ostream": "cpp",
-        "semaphore": "cpp",
-        "sstream": "cpp",
-        "stdexcept": "cpp",
-        "stop_token": "cpp",
-        "streambuf": "cpp",
-        "thread": "cpp",
-        "typeinfo": "cpp",
-        "complex": "cpp",
-        "immintrin.h": "c",
-        "__bit_reference": "cpp",
-        "__bits": "cpp",
-        "__config": "cpp",
-        "__debug": "cpp",
-        "__errc": "cpp",
-        "__hash_table": "cpp",
-        "__locale": "cpp",
-        "__mutex_base": "cpp",
-        "__node_handle": "cpp",
-        "__split_buffer": "cpp",
-        "__threading_support": "cpp",
-        "__tuple": "cpp",
-        "__verbose_abort": "cpp",
-        "charconv": "cpp",
-        "ios": "cpp",
-        "locale": "cpp",
-        "optional": "cpp",
-        "variant": "cpp",
-        "__nullptr": "cpp",
-        "unordered_set": "cpp",
-        "span": "cpp",
-        "arm_neon.h": "c",
-        "__tree": "cpp",
-        "filesystem": "cpp"
-    },
-    "cSpell.words": [
-        "castsi",
-        "dtype",
-        "dtypes",
-        "jaccard",
-        "kann",
-        "Kullback",
-        "Leibler",
-        "loadu",
-        "maccs",
-        "maskz",
-        "napi",
-        "simd",
-        "simsimd",
-        "sqeuclidean",
-        "tanimoto",
-        "typedarray",
-        "unsw",
-        "Vardanian",
-        "vpopcntdq"
-    ]
-}

package/simsimd/.vscode/tasks.json

@@ -1,23 +0,0 @@
-{
-    "version": "2.0.0",
-    "tasks": [
-        {
-            "label": "Build Benchmark: Debug",
-            "command": "cmake -DCMAKE_BUILD_TYPE=Debug -DSIMSIMD_BUILD_BENCHMARKS=1 -B ./build_debug && make -j 2 -C ./build_debug",
-            "args": [],
-            "type": "shell"
-        },
-        {
-            "label": "Build Test: Debug",
-            "command": "cmake -DCMAKE_BUILD_TYPE=Debug -B ./build && make test py_simsimd -C ./build",
-            "args": [],
-            "type": "shell"
-        },
-        {
-            "label": "Build Benchmark: Release",
-            "command": "cmake -DCMAKE_BUILD_TYPE=RelWithDebInfo -DSIMSIMD_BUILD_BENCHMARKS=1 -B ./build_release && make -j 2 -C ./build_release",
-            "args": [],
-            "type": "shell"
-        }
-    ]
-}

package/simsimd/go.mod

@@ -1,3 +0,0 @@
-module github.com/ashvardanian/simsimd
-
-go 1.19

package/simsimd/golang/bench_test.go

@@ -1,40 +0,0 @@
-package simsimd
-
-import (
-	"math"
-	"math/rand"
-	"testing"
-)
-
-func cosineSimilarity(a, b []float32) float32 {
-	var dotProduct float32
-	var normA, normB float32
-	for i := range a {
-		dotProduct += a[i] * b[i]
-		normA += a[i] * a[i]
-		normB += b[i] * b[i]
-	}
-	return dotProduct / (float32(math.Sqrt(float64(normA))) * float32(math.Sqrt(float64(normB))))
-}
-
-func generateRandomVector(dim int) []float32 {
-	vec := make([]float32, dim)
-	for i := range vec {
-		vec[i] = rand.Float32()
-	}
-	return vec
-}
-
-func BenchmarkCosineSimilarityNative(b *testing.B) {
-    first, second := generateRandomVector(1536), generateRandomVector(1536)
-    for i := 0; i < b.N; i++ {
-        cosineSimilarity(first, second)
-    }
-}
-
-func BenchmarkCosineSimilaritySIMD(b *testing.B) {
-    first, second := generateRandomVector(1536), generateRandomVector(1536)
-    for i := 0; i < b.N; i++ {
-        CosineF32(first, second)
-    }
-}

package/simsimd/golang/simsimd.go

@@ -1,47 +0,0 @@
-package simsimd
-
-/*
-#cgo CFLAGS: -O3
-#cgo LDFLAGS: -O3 -L.
-#include "../simsimd/simsimd.h"
-#include <stdlib.h>
-
-inline static simsimd_f32_t cosine_i8(simsimd_i8_t const* a, simsimd_i8_t const* b, simsimd_size_t d) { return simsimd_metric_punned(simsimd_metric_cosine_k, simsimd_datatype_i8_k, simsimd_cap_any_k)(a, b, d, d); }
-inline static simsimd_f32_t cosine_f32(simsimd_f32_t const* a, simsimd_f32_t const* b, simsimd_size_t d) { return simsimd_neon_f32_cos(a, b, d); }
-inline static simsimd_f32_t inner_i8(simsimd_i8_t const* a, simsimd_i8_t const* b, simsimd_size_t d) { return simsimd_metric_punned(simsimd_metric_inner_k, simsimd_datatype_i8_k, simsimd_cap_any_k)(a, b, d, d); }
-inline static simsimd_f32_t inner_f32(simsimd_f32_t const* a, simsimd_f32_t const* b, simsimd_size_t d) { return simsimd_metric_punned(simsimd_metric_inner_k, simsimd_datatype_f32_k, simsimd_cap_any_k)(a, b, d, d); }
-inline static simsimd_f32_t sqeuclidean_i8(simsimd_i8_t const* a, simsimd_i8_t const* b, simsimd_size_t d) { return simsimd_metric_punned(simsimd_metric_sqeuclidean_k, simsimd_datatype_i8_k, simsimd_cap_any_k)(a, b, d, d); }
-inline static simsimd_f32_t sqeuclidean_f32(simsimd_f32_t const* a, simsimd_f32_t const* b, simsimd_size_t d) { return simsimd_metric_punned(simsimd_metric_sqeuclidean_k, simsimd_datatype_f32_k, simsimd_cap_any_k)(a, b, d, d); }
-*/
-import "C"
-
-
-// CosineI8 computes the cosine similarity between two i8 vectors using the most suitable SIMD instruction set available.
-func CosineI8(a, b []int8) float32 {
-	return float32(C.cosine_i8((*C.simsimd_i8_t)(&a[0]), (*C.simsimd_i8_t)(&b[0]), C.simsimd_size_t(len(a))))
-}
-
-// CosineF32 computes the cosine similarity between two i8 vectors using the most suitable SIMD instruction set available.
-func CosineF32(a, b []float32) float32 {
-	return float32(C.cosine_f32((*C.simsimd_f32_t)(&a[0]), (*C.simsimd_f32_t)(&b[0]), C.simsimd_size_t(len(a))))
-}
-
-// InnerI8 computes the inner-product similarity between two i8 vectors using the most suitable SIMD instruction set available.
-func InnerI8(a, b []int8) float32 {
-	return float32(C.inner_i8((*C.simsimd_i8_t)(&a[0]), (*C.simsimd_i8_t)(&b[0]), C.simsimd_size_t(len(a))))
-}
-
-// InnerF32 computes the inner-product similarity between two i8 vectors using the most suitable SIMD instruction set available.
-func InnerF32(a, b []float32) float32 {
-	return float32(C.inner_f32((*C.simsimd_f32_t)(&a[0]), (*C.simsimd_f32_t)(&b[0]), C.simsimd_size_t(len(a))))
-}
-
-// SqEuclideanI8 computes the squared euclidean similarity between two i8 vectors using the most suitable SIMD instruction set available.
-func SqEuclideanI8(a, b []int8) float32 {
-	return float32(C.sqeuclidean_i8((*C.simsimd_i8_t)(&a[0]), (*C.simsimd_i8_t)(&b[0]), C.simsimd_size_t(len(a))))
-}
-
-// SqEuclideanF32 computes the squared euclidean similarity between two i8 vectors using the most suitable SIMD instruction set available.
-func SqEuclideanF32(a, b []float32) float32 {
-	return float32(C.sqeuclidean_f32((*C.simsimd_f32_t)(&a[0]), (*C.simsimd_f32_t)(&b[0]), C.simsimd_size_t(len(a))))
-}

package/simsimd/golang/unit_test.go

@@ -1,40 +0,0 @@
-package simsimd
-
-import (
-	"math"
-	"testing"
-)
-
-func TestCosineI8(t *testing.T) {
-	a := []int8{1, 0}
-	b := []int8{0, 1}
-
-	result := CosineI8(a, b)
-	expected := float32(1.0) // Cosine similarity of orthogonal vectors is 0
-	if math.Abs(float64(result-expected)) > 1e-3 {
-		t.Errorf("Expected %v, got %v", expected, result)
-	}
-}
-
-func TestCosineF32(t *testing.T) {
-	a := []float32{1, 0}
-	b := []float32{0, 1}
-
-	result := CosineF32(a, b)
-	expected := float32(1.0) // Cosine similarity of orthogonal vectors is 0
-	if math.Abs(float64(result-expected)) > 1e-3 {
-		t.Errorf("Expected %v, got %v", expected, result)
-	}
-}
-
-func TestVectorLengthMismatch(t *testing.T) {
-	defer func() {
-		if r := recover(); r == nil {
-			t.Errorf("The code did not panic")
-		}
-	}()
-
-	a := []int8{1, 0}
-	b := []int8{0}
-	_ = CosineI8(a, b) // This should panic
-}

package/simsimd/pyproject.toml

@@ -1,42 +0,0 @@
-[build-system]
-requires = ["setuptools>=42", "wheel", "numpy"]
-build-backend = "setuptools.build_meta"
-
-[tool.pytest.ini_options]
-minversion = "6.0"
-addopts = ["-ra", "--showlocals", "--strict-markers", "--strict-config"]
-xfail_strict = true
-filterwarnings = ["error"]
-
-[tool.cibuildwheel]
-test-requires = ["pytest", "pytest-repeat", "scipy"]
-test-command = "pytest {project}/python/test.py -s -x"
-build-verbosity = 0
-skip = ["*musllinux*", "*i686*", "pp*", "cp36-*", "cp37-*"]
-
-[tool.cibuildwheel.linux]
-before-build = [
-    "rm -rf {project}/build",
-]
-manylinux-x86_64-image = "manylinux_2_28"
-manylinux-aarch64-image = "manylinux_2_28"
-
-archs = ["x86_64", "aarch64"]
-before-all = [
-    "yum install -y glibc-devel wget python3-devel"
-]
-repair-wheel-command = "auditwheel repair --lib-sdir . -w {dest_dir} {wheel}"
-
-[tool.cibuildwheel.macos]
-before-build = [
-    "rm -rf {project}/build",
-]
-archs = ["x86_64", "arm64"]
-repair-wheel-command = "delocate-wheel --require-archs {delocate_archs} -w {dest_dir} -v {wheel}"
-
-[tool.cibuildwheel.windows]
-before-build = [
-   "rd /s /q {project}\\build || echo Done",
-]
-archs = ["x86", "AMD64"]
-skip = ["*win32*", "pp*"]