usearch 2.1.1 → 2.1.3

package/.github/workflows/prerelease.yml

@@ -74,8 +74,9 @@ jobs:
     name: Test Python
     runs-on: ${{ matrix.os }}
     strategy:
+      fail-fast: false
       matrix:
-        os: [ubuntu-20.04, macOS-11, windows-2022]
+        os: [ubuntu-22.04, macOS-11, windows-2022]
         python-version: ["3.11"]
 
     steps:
@@ -89,8 +90,16 @@ jobs:
         run: |
           python -m pip install --upgrade pip
           pip install pytest numpy
+      - name: Build locally on Ubuntu
+        run: |
+          export CC=/usr/bin/gcc-12
+          export CXX=/usr/bin/g++-12
+          export LD_LIBRARY_PATH=/usr/lib/gcc/x86_64-linux-gnu/12/:$LD_LIBRARY_PATH
+          python -m pip install .
+        if: ${{ matrix.os == 'ubuntu-22.04' }}
       - name: Build locally
         run: python -m pip install .
+        if: ${{ matrix.os != 'ubuntu-22.04' }}
       - name: Test with PyTest
         run: pytest python/scripts/
 
@@ -99,8 +108,9 @@ jobs:
     name: Test Python 3.7
     runs-on: ${{ matrix.os }}
     strategy:
+      fail-fast: false
       matrix:
-        os: [ubuntu-20.04]
+        os: [ubuntu-22.04]
         python-version: ["3.7"]
 
     steps:
@@ -118,7 +128,12 @@ jobs:
           pip install pytest numpy
 
       - name: Build locally
-        run: python -m pip install .
+        run: |
+          export CC=/usr/bin/gcc-12
+          export CXX=/usr/bin/g++-12
+          export LD_LIBRARY_PATH=/usr/lib/gcc/x86_64-linux-gnu/12/:$LD_LIBRARY_PATH
+          python -m pip install .
+        if: ${{ matrix.os == 'ubuntu-22.04' }}
 
       - name: Test with PyTest
         run: pytest python/scripts/

package/.github/workflows/release.yml

@@ -30,7 +30,7 @@ jobs:
 
 
   rebase:
-    name: Rebase Development Branch
+    name: Rebase Dev. Branch
     needs: versioning
     runs-on: ubuntu-latest
     steps:
@@ -41,13 +41,14 @@ 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
@@ -239,12 +240,14 @@ jobs:
     - 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
+        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
@@ -255,8 +258,14 @@ jobs:
         replacebody: false
         body: |
             ## Hashes
-            * Source code (zip) : `${{ steps.hashes.outputs.zip_hash }}` 
-            * Source code (tar.gz) : `${{ steps.hashes.outputs.tar_hash }}`
+            * ${{ 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:

package/CMakeLists.txt

@@ -49,11 +49,26 @@ else()
     target_compile_features(${USEARCH_TARGET_NAME} INTERFACE cxx_std_11)
 endif()
 
+# Core compilation settings affecting "index.hpp"
 target_compile_definitions(
     ${USEARCH_TARGET_NAME}
     INTERFACE
     $<$<NOT:$<BOOL:${JSON_GlobalUDLs}>>:USEARCH_USE_OPENMP=0>
 )
+
+# Supplementary compilation settings affecting "index_plugins.hpp"
+target_compile_definitions(
+    ${USEARCH_TARGET_NAME}
+    INTERFACE
+    $<$<NOT:$<BOOL:${JSON_GlobalUDLs}>>:USEARCH_USE_NATIVE_F16=0>
+)
+
+target_compile_definitions(
+    ${USEARCH_TARGET_NAME}
+    INTERFACE
+    $<$<NOT:$<BOOL:${JSON_GlobalUDLs}>>:USEARCH_USE_SIMSIMD=0>
+)
+
 target_include_directories(
     ${USEARCH_TARGET_NAME}
     ${USEARCH_SYSTEM_INCLUDE} INTERFACE

package/Cargo.toml

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

package/README.md

@@ -39,8 +39,8 @@ Linux • MacOS • Windows • iOS • Docker • WebAssembly
 <a href="https://pypi.org/project/usearch/"> <img alt="PyPI - Downloads" src="https://img.shields.io/pypi/dm/usearch?label=pypi%20downloads"> </a>
 <a href="https://www.npmjs.com/package/usearch"> <img alt="npm" src="https://img.shields.io/npm/dy/usearch?label=npm%20dowloads"> </a>
 <a href="https://crates.io/crates/usearch"> <img alt="Crates.io" src="https://img.shields.io/crates/d/usearch?label=crate%20downloads"> </a>
-<a href="https://www.nuget.org/packages/Cloud.Unum.USearch"> <img alt="Nuget" src="https://img.shields.io/nuget/dt/Cloud.Unum.USearch?style=social&label=NuGet"> </a>
-<a href="https://hub.docker.com/r/unum/usearch"> <img alt="Docker Pulls" src="https://img.shields.io/docker/pulls/unum/usearch?style=social&label=Docker"> </a>
+<a href="https://www.nuget.org/packages/Cloud.Unum.USearch"> <img alt="Nuget" src="https://img.shields.io/nuget/dt/Cloud.Unum.USearch?label=NuGet"> </a>
+<a href="https://hub.docker.com/r/unum/usearch"> <img alt="Docker Pulls" src="https://img.shields.io/docker/pulls/unum/usearch?label=Docker"> </a>
 <img alt="GitHub code size in bytes" src="https://img.shields.io/github/languages/code-size/unum-cloud/usearch">
 </div>
 
@@ -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.1'
+    version = '2.1.3'
     license = 'Apache 2.0'
     url = 'https://github.com/unum-cloud/usearch'
     description = 'Smaller & Faster Single-File Vector Search Engine from Unum'

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/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/include/usearch/index_plugins.hpp

@@ -41,6 +41,12 @@
 #endif
 
 #if USEARCH_USE_SIMSIMD
+#if __linux__
+#define SIMSIMD_TARGET_ARM_NEON 1
+#define SIMSIMD_TARGET_X86_AVX2 1
+#define SIMSIMD_TARGET_ARM_SVE 1
+#define SIMSIMD_TARGET_X86_AVX512 1
+#endif
 #include <simsimd/simsimd.h>
 #endif
 
@@ -600,9 +606,7 @@ class aligned_allocator_gt {
     using size_type = std::size_t;
     using pointer = element_at*;
     using const_pointer = element_at const*;
-    template <typename other_element_at> struct rebind {
-        using other = aligned_allocator_gt<other_element_at>;
-    };
+    template <typename other_element_at> struct rebind { using other = aligned_allocator_gt<other_element_at>; };
 
     constexpr std::size_t alignment() const { return alignment_ak; }
 
@@ -1384,25 +1388,37 @@ class metric_punned_t {
     // clang-format off
     static metric_punned_t ip_metric_f32_(std::size_t bytes_per_vector) {
         #if USEARCH_USE_SIMSIMD
-        if (hardware_supports(isa_kind_t::sve_k)) return {pun_stl_<f32_t>([=](f32_t const* a, f32_t const* b) { return simsimd_dot_f32_sve(a, b, bytes_per_vector / 4); }), bytes_per_vector, metric_kind_t::ip_k, scalar_kind_t::f32_k, isa_kind_t::sve_k};
+        #if SIMSIMD_TARGET_ARM_NEON
         if (hardware_supports(isa_kind_t::neon_k) && bytes_per_vector % 16 == 0) return {pun_stl_<f32_t>([=](f32_t const* a, f32_t const* b) { return simsimd_dot_f32x4_neon(a, b, bytes_per_vector / 4); }), bytes_per_vector, metric_kind_t::ip_k, scalar_kind_t::f32_k, isa_kind_t::neon_k};
+        #endif
+        #if SIMSIMD_TARGET_ARM_SVE
+        if (hardware_supports(isa_kind_t::sve_k)) return {pun_stl_<f32_t>([=](f32_t const* a, f32_t const* b) { return simsimd_dot_f32_sve(a, b, bytes_per_vector / 4); }), bytes_per_vector, metric_kind_t::ip_k, scalar_kind_t::f32_k, isa_kind_t::sve_k};
+        #endif
+        #if SIMSIMD_TARGET_X86_AVX2
         if (hardware_supports(isa_kind_t::avx2_k) && bytes_per_vector % 16 == 0) return {pun_stl_<f32_t>([=](f32_t const* a, f32_t const* b) { return simsimd_dot_f32x4_avx2(a, b, bytes_per_vector / 4); }), bytes_per_vector, metric_kind_t::ip_k, scalar_kind_t::f32_k, isa_kind_t::avx2_k};
         #endif
+        #endif
         return {to_stl_<metric_ip_gt<f32_t>>(bytes_per_vector), bytes_per_vector, metric_kind_t::ip_k, scalar_kind_t::f32_k, isa_kind_t::auto_k};
     }
 
     static metric_punned_t cos_metric_f16_(std::size_t bytes_per_vector) {
         #if USEARCH_USE_SIMSIMD
+        #if SIMSIMD_TARGET_X86_AVX512
         if (hardware_supports(isa_kind_t::avx512_k) && bytes_per_vector % 32 == 0) return {pun_stl_<simsimd_f16_t>([=](simsimd_f16_t const* a, simsimd_f16_t const* b) { return simsimd_cos_f16x16_avx512(a, b, bytes_per_vector / 2); }), bytes_per_vector, metric_kind_t::cos_k, scalar_kind_t::f16_k, isa_kind_t::avx512_k};
+        #endif
+        #if SIMSIMD_TARGET_ARM_NEON
         if (hardware_supports(isa_kind_t::neon_k) && bytes_per_vector % 8 == 0) return {pun_stl_<simsimd_f16_t>([=](simsimd_f16_t const* a, simsimd_f16_t const* b) { return simsimd_cos_f16x4_neon(a, b, bytes_per_vector / 2); }), bytes_per_vector, metric_kind_t::cos_k, scalar_kind_t::f16_k, isa_kind_t::neon_k};
         #endif
+        #endif
         return {to_stl_<metric_cos_gt<f16_t, f32_t>>(bytes_per_vector), bytes_per_vector, metric_kind_t::cos_k, scalar_kind_t::f16_k, isa_kind_t::auto_k};
     }
 
     static metric_punned_t cos_metric_i8_(std::size_t bytes_per_vector) {
         #if USEARCH_USE_SIMSIMD
+        #if SIMSIMD_TARGET_ARM_NEON
         if (hardware_supports(isa_kind_t::neon_k) && bytes_per_vector % 16 == 0) return {pun_stl_<int8_t>([=](int8_t const* a, int8_t const* b) { return simsimd_cos_i8x16_neon(a, b, bytes_per_vector); }), bytes_per_vector, metric_kind_t::cos_k, scalar_kind_t::i8_k, isa_kind_t::neon_k};
         #endif
+        #endif
         return {to_stl_<cos_i8_t>(bytes_per_vector), bytes_per_vector, metric_kind_t::cos_k, scalar_kind_t::i8_k, isa_kind_t::auto_k};
     }
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "usearch",
-    "version": "2.1.1",
+    "version": "2.1.3",
     "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

@@ -7,10 +7,7 @@ from pybind11.setup_helpers import Pybind11Extension
 
 compile_args = []
 link_args = []
-macros_args = [
-    ("USEARCH_USE_NATIVE_F16", "0"),
-    ("USEARCH_USE_SIMSIMD", "0"),
-]
+macros_args = []
 
 if sys.platform == "linux":
     compile_args.append("-std=c++17")
@@ -18,6 +15,8 @@ if sys.platform == "linux":
     compile_args.append("-g")  # Simplify debugging
     compile_args.append("-Wno-unknown-pragmas")
 
+    macros_args.append(("USEARCH_USE_NATIVE_F16", "0"))
+    macros_args.append(("USEARCH_USE_SIMSIMD", "1"))
     macros_args.append(("USEARCH_USE_OPENMP", "1"))
     compile_args.append("-fopenmp")
     link_args.append("-lgomp")
@@ -66,6 +65,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/simsimd/.github/workflows/prerelease.yml

@@ -21,8 +21,9 @@ jobs:
     name: Test Python
     runs-on: ${{ matrix.os }}
     strategy:
+      fail-fast: false
       matrix:
-        os: [ubuntu-20.04, macOS-11, windows-2022]
+        os: [ubuntu-22.04] # macOS-11, windows-2022
         python-version: ["3.11"]
 
     steps:
@@ -32,22 +33,54 @@ jobs:
         uses: actions/setup-python@v4
         with:
           python-version: ${{ matrix.python-version }}
+
+      - name: Set up Clang
+        run: brew install llvm
+        if: ${{ matrix.os == 'macOS-11' }}
+
+      - name: Set up MinGW
+        uses: egor-tensin/setup-mingw@v2
+        with:
+          platform: x64
+        if: ${{ matrix.os == 'windows-2022' }}
+        
       - name: Install dependencies
         run: |
           python -m pip install --no-cache-dir --upgrade pip
           pip install --no-cache-dir pytest
-      - name: Build locally
-        run: python -m pip install .
+          
+      - name: Build locally on Ubuntu
+        run: |
+          export CC=/usr/bin/gcc-12
+          export CXX=/usr/bin/g++-12
+          export LD_LIBRARY_PATH=/usr/lib/gcc/x86_64-linux-gnu/12/:$LD_LIBRARY_PATH
+          python -m pip install .
+        if: ${{ matrix.os == 'ubuntu-22.04' }}
+
+      - name: Build locally on MacOS
+        run: |
+          export LDFLAGS="-L/usr/local/opt/llvm/lib"
+          export CPPFLAGS="-I/usr/local/opt/llvm/include"
+          export CC=/usr/local/opt/llvm/bin/clang
+          export CXX=/usr/local/opt/llvm/bin/clang++
+          python -m pip install .
+        if: ${{ matrix.os == 'macOS-11' }}
+
+      - name: Build locally on Windows
+        run: |
+          python -m pip install .
+        if: ${{ matrix.os == 'windows-2022' }}
+        
       - name: Test with PyTest
         run: pytest python/test.py
-
+        
 
   test_python_37:
     name: Test Python 3.7
     runs-on: ${{ matrix.os }}
     strategy:
       matrix:
-        os: [ubuntu-20.04]
+        os: [ubuntu-22.04]
         python-version: ["3.7"]
 
     steps:
@@ -65,9 +98,11 @@ jobs:
           pip install --no-cache-dir pytest
 
       - name: Build locally
-        run: python -m pip install .
-
+        run: |
+          export CC=/usr/bin/gcc-12
+          export CXX=/usr/bin/g++-12
+          export LD_LIBRARY_PATH=/usr/lib/gcc/x86_64-linux-gnu/12/:$LD_LIBRARY_PATH
+          python -m pip install .
+        
       - name: Test with PyTest
         run: pytest python/test.py
-
-

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

@@ -29,7 +29,7 @@ jobs:
 
 
   rebase:
-    name: Rebase Development Branch
+    name: Rebase Dev. Branch
     needs: versioning
     runs-on: ubuntu-latest
     steps:
@@ -57,7 +57,7 @@ jobs:
     needs: versioning
     strategy:
       matrix:
-        os: [ubuntu-20.04, macOS-11, windows-2022]
+        os: [ubuntu-20.04] # macOS-11, windows-2022
 
     steps:
       - uses: actions/checkout@v3
@@ -66,13 +66,11 @@ jobs:
       - uses: actions/setup-python@v3
       
       - name: Setup Docker
-        if: matrix.os != 'windows-2022'
-        uses: crazy-max/ghaction-setup-docker@v1.0.0
-        with:
-          version: 23.0.1
-
+        if: matrix.os == 'ubuntu-20.04'
+        uses: docker-practice/actions-setup-docker@master
+        
       - name: Setup QEMU
-        if: matrix.os != 'windows-2022'
+        if: matrix.os == 'ubuntu-20.04'
         uses: docker/setup-qemu-action@v2.1.0
 
       - name: Install CIBuildWheel
@@ -92,7 +90,7 @@ jobs:
     runs-on: ubuntu-20.04
     environment:
       name: pypi
-      url: https://pypi.org/p/stringzilla
+      url: https://pypi.org/p/simsimd
     permissions:
       id-token: write
 

package/simsimd/.vscode/settings.json

@@ -85,13 +85,17 @@
         "variant": "cpp",
         "__nullptr": "cpp",
         "unordered_set": "cpp",
-        "span": "cpp"
+        "span": "cpp",
+        "arm_neon.h": "c"
     },
     "cSpell.words": [
         "dtype",
         "dtypes",
         "kann",
+        "maccs",
+        "simd",
         "simsimd",
+        "tanimoto",
         "unsw"
     ]
 }