feat: introduce turbo.

examples/c++/CMakeLists.txt

@@ -43,7 +43,7 @@ set(zvec_ailego_deps
 )
 
 set(zvec_core_deps
-    # empty
+    zvec_turbo
 )
 
 set(zvec_db_deps

src/CMakeLists.txt

@@ -8,6 +8,7 @@ git_version(ZVEC_VERSION ${CMAKE_CURRENT_SOURCE_DIR})
 cc_directory(ailego)
 cc_directory(core)
 cc_directory(db)
+cc_directory(turbo)
 if(BUILD_PYTHON_BINDINGS)
     cc_directory(binding)
 endif()

src/core/CMakeLists.txt

@@ -15,7 +15,7 @@ file(GLOB_RECURSE ALL_CORE_SRCS *.cc *.c *.h)
 cc_library(
     NAME zvec_core STATIC STRICT PACKED
     SRCS ${ALL_CORE_SRCS}
-    LIBS zvec_ailego sparsehash magic_enum
+    LIBS zvec_ailego zvec_turbo sparsehash magic_enum
     INCS . ${PROJECT_ROOT_DIR}/src/core
     VERSION "${GIT_SRCS_VER}"
 )

src/core/metric/CMakeLists.txt

@@ -5,7 +5,7 @@ cc_library(
     NAME core_metric 
     STATIC SHARED STRICT ALWAYS_LINK
     SRCS *.cc
-    LIBS zvec_ailego core_framework 
+    LIBS zvec_ailego zvec_turbo core_framework 
     INCS . ${PROJECT_ROOT_DIR}/src/core
     VERSION "${PROXIMA_ZVEC_VERSION}"
   )

src/core/metric/quantized_integer_metric.cc

@@ -18,6 +18,7 @@
 #include <ailego/math_batch/distance_batch.h>
 #include <zvec/core/framework/index_error.h>
 #include <zvec/core/framework/index_factory.h>
+#include <zvec/turbo/turbo.h>
 #include "metric_params.h"
 #include "quantized_integer_metric_batch.h"
 #include "quantized_integer_metric_matrix.h"
@@ -95,6 +96,12 @@ class QuantizedIntegerMetric : public IndexMetric {
     switch (origin_metric_type_) {
       case MetricType::kSquaredEuclidean:
         if (meta_.data_type() == IndexMeta::DataType::DT_INT8) {
+          auto turbo_ret = turbo::get_distance_func(
+              turbo::MetricType::kSquaredEuclidean, turbo::DataType::kInt8,
+              turbo::QuantizeType::kDefault);
+          if (turbo_ret) {
+            return turbo_ret;
+          }
           return DistanceMatrixCompute<SquaredEuclidean, int8_t>(m, n);
         }
         if (meta_.data_type() == IndexMeta::DataType::DT_INT4) {
@@ -146,6 +153,12 @@ class QuantizedIntegerMetric : public IndexMetric {
     switch (origin_metric_type_) {
       case MetricType::kSquaredEuclidean:
         if (meta_.data_type() == IndexMeta::DataType::DT_INT8) {
+          auto turbo_ret = turbo::get_batch_distance_func(
+              turbo::MetricType::kSquaredEuclidean, turbo::DataType::kInt8,
+              turbo::QuantizeType::kDefault);
+          if (turbo_ret) {
+            return turbo_ret;
+          }
           return reinterpret_cast<IndexMetric::MatrixBatchDistanceHandle>(
               BaseDistanceBatchWithScoreUnquantized<SquaredEuclidean, int8_t,
                                                     12, 2>::ComputeBatch);
@@ -268,6 +281,12 @@ class QuantizedIntegerMetric : public IndexMetric {
           int8_t, 1, 1>::GetQueryPreprocessFunc();
     } else if (origin_metric_type_ == MetricType::kSquaredEuclidean &&
                meta_.data_type() == IndexMeta::DataType::DT_INT8) {
+      auto turbo_ret = turbo::get_query_preprocess_func(
+          turbo::MetricType::kSquaredEuclidean, turbo::DataType::kInt8,
+          turbo::QuantizeType::kDefault);
+      if (turbo_ret) {
+        return turbo_ret;
+      }
       return SquaredEuclideanDistanceBatchWithScoreUnquantized<
           int8_t, 1, 1>::GetQueryPreprocessFunc();
     }

src/include/zvec/turbo/turbo.h

@@ -0,0 +1,53 @@
+// Copyright 2025-present the zvec project
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+#pragma once
+
+#include <functional>
+#include <zvec/ailego/math_batch/utils.h>
+
+namespace zvec::turbo {
+
+using DistanceFunc =
+    std::function<void(const void *m, const void *q, size_t dim, float *out)>;
+using BatchDistanceFunc = std::function<void(
+    const void **m, const void *q, size_t num, size_t dim, float *out)>;
+using QueryPreprocessFunc =
+    zvec::ailego::DistanceBatch::DistanceBatchQueryPreprocessFunc;
+
+enum class MetricType {
+  kSquaredEuclidean,
+  kUnknown,
+};
+
+enum class DataType {
+  kInt8,
+  kUnknown,
+};
+
+enum class QuantizeType {
+  kDefault,
+};
+
+DistanceFunc get_distance_func(MetricType metric_type, DataType data_type,
+                               QuantizeType quantize_type);
+
+BatchDistanceFunc get_batch_distance_func(MetricType metric_type,
+                                          DataType data_type,
+                                          QuantizeType quantize_type);
+
+QueryPreprocessFunc get_query_preprocess_func(MetricType metric_type,
+                                              DataType data_type,
+                                              QuantizeType quantize_type);
+
+}  // namespace zvec::turbo

src/turbo/CMakeLists.txt

@@ -0,0 +1,25 @@
+include(${PROJECT_ROOT_DIR}/cmake/bazel.cmake)
+include(${PROJECT_ROOT_DIR}/cmake/option.cmake)
+
+if(NOT ANDROID AND AUTO_DETECT_ARCH)
+    if(CMAKE_SYSTEM_PROCESSOR MATCHES "x86_64|i686|i386|x64")
+        setup_compiler_march_for_x86(TURBO_MARCH_FLAG_SSE TURBO_MARCH_FLAG_AVX2 TURBO_MARCH_FLAG_AVX512)
+        set_source_files_properties(
+            ${CMAKE_CURRENT_SOURCE_DIR}/euclidean/avx512_impl.cc
+            PROPERTIES
+            COMPILE_FLAGS "${TURBO_MARCH_FLAG_AVX512}"
+        )
+    elseif(CMAKE_SYSTEM_PROCESSOR MATCHES "aarch64|arm64|ARM64")
+        # ARM64 architecture - no special march flags needed for now
+        # NEON implementations can be added here if needed
+        message(STATUS "turbo: ARM64 detected, skipping x86-specific optimizations")
+    endif()
+endif()
+
+file(GLOB_RECURSE ALL_SRCS *.cc *.c *.h)
+
+cc_library(
+    NAME zvec_turbo STATIC STRICT PACKED
+    SRCS ${ALL_SRCS}
+    INCS ${PROJECT_ROOT_DIR}/src/include/zvec
+)