fix: prevent pyzmq compilation during tests

- Cap pyzmq version to <27 for manylinux2014 compatibility
- Pre-install pyzmq binary wheel before tests using CIBW_BEFORE_TEST
- Force pip to use only binary wheels with --only-binary :all:

Author: andylizf

.github/workflows/build-cibuildwheel.yml

@@ -68,6 +68,10 @@ jobs:
           CIBW_BEFORE_ALL_MACOS: |
             brew install boost zeromq openblas cmake libomp
           
+          # Pre-install test dependencies to avoid compilation
+          CIBW_BEFORE_TEST: |
+            pip install --only-binary :all: "pyzmq>=23.0.0,<27"
+          
           # Test command to verify the wheel works
           CIBW_TEST_COMMAND: |
             python -c "import leann_backend_hnsw; print('HNSW backend imported successfully')"
@@ -125,15 +129,19 @@ jobs:
           CIBW_BEFORE_ALL_MACOS: |
             brew install boost zeromq openblas cmake libomp
           
+          # Pre-install test dependencies to avoid compilation
+          CIBW_BEFORE_TEST: |
+            pip install --only-binary :all: "pyzmq>=23.0.0,<27"
+          
           # Test command to verify the wheel works
           CIBW_TEST_COMMAND: |
             python -c "import leann_backend_diskann; print('DiskANN backend imported successfully')"
           
           # Skip problematic configurations
           CIBW_TEST_SKIP: "*-macosx_arm64"  # Skip ARM64 tests on GitHub Actions
 
-          # Test dependencies - install pre-built pyzmq to avoid compilation issues
-          CIBW_TEST_REQUIRES: "pytest numpy pyzmq"
+          # Test dependencies - avoid pyzmq due to manylinux2014 compatibility issues
+          CIBW_TEST_REQUIRES: "pytest numpy"
 
           CIBW_ENVIRONMENT: |
             CMAKE_BUILD_PARALLEL_LEVEL=8

check_pyzmq_wheels.py

@@ -0,0 +1,41 @@
+#!/usr/bin/env python3
+"""Check which pyzmq versions have manylinux2014 wheels available."""
+
+import json
+import urllib.request
+
+
+def check_pyzmq_wheels():
+    url = "https://pypi.org/pypi/pyzmq/json"
+    with urllib.request.urlopen(url) as response:
+        data = json.loads(response.read())
+
+    versions_with_manylinux2014 = {}
+
+    for version, releases in data["releases"].items():
+        manylinux_wheels = []
+        for release in releases:
+            filename = release["filename"]
+            if "manylinux2014" in filename or "manylinux_2_17" in filename:
+                if "cp310" in filename:  # Python 3.10
+                    manylinux_wheels.append(filename)
+
+        if manylinux_wheels:
+            versions_with_manylinux2014[version] = manylinux_wheels
+
+    # Sort versions
+    from packaging.version import parse
+
+    sorted_versions = sorted(
+        versions_with_manylinux2014.keys(), key=parse, reverse=True
+    )
+
+    print("PyZMQ versions with manylinux2014 wheels for Python 3.10:")
+    for version in sorted_versions[:10]:  # Show top 10
+        print(f"  {version}")
+        for wheel in versions_with_manylinux2014[version]:
+            print(f"    - {wheel}")
+
+
+if __name__ == "__main__":
+    check_pyzmq_wheels()

packages/leann-backend-hnsw/pyproject.toml

@@ -11,7 +11,7 @@ description = "Custom-built HNSW (Faiss) backend for the Leann toolkit."
 dependencies = [
     "leann-core==0.1.8", 
     "numpy",
-    "pyzmq>=23.0.0",
+    "pyzmq>=23.0.0,<27",  # Cap at 26.x for manylinux2014 compatibility
     "msgpack>=1.0.0",
 ]
 

packages/leann-core/pyproject.toml

@@ -15,7 +15,7 @@ dependencies = [
     "numpy>=1.20.0",
     "tqdm>=4.60.0",
     "psutil>=5.8.0",
-    "pyzmq>=23.0.0",
+    "pyzmq>=23.0.0,<27",  # Cap at 26.x for manylinux2014 compatibility
     "msgpack>=1.0.0",
     "torch>=2.0.0",
     "sentence-transformers>=2.2.0",