chore: release v0.1.2

- Enhanced bump_version.sh to automatically update leann-core dependency versions
- Script now updates both package versions and their leann-core dependencies
- This ensures version consistency across all packages during release

No more manual dependency version updates needed!

.github/workflows/build-and-publish.yml

@@ -1,15 +1,14 @@
-name: Build and Publish to PyPI
+name: CI - Build Multi-Platform Packages
 
 on:
-  release:
-    types: [published]
   push:
-    tags:
-      - 'v*'
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
   workflow_dispatch:
     inputs:
       publish:
-        description: 'Publish to PyPI'
+        description: 'Publish to PyPI (only use for emergency fixes)'
         required: true
         default: 'false'
         type: choice
@@ -221,12 +220,12 @@ jobs:
           name: leann-meta-dist
           path: packages/leann/dist/
 
-  # Publish to PyPI
+  # Publish to PyPI (only for emergency fixes or manual triggers)
   publish:
-    name: Publish to PyPI
+    name: Publish to PyPI (Emergency)
     needs: [build-core, build-hnsw, build-diskann, build-meta]
     runs-on: ubuntu-latest
-    if: github.event_name == 'release' || github.event.inputs.publish != 'false'
+    if: github.event_name == 'workflow_dispatch' && github.event.inputs.publish != 'false'
     
     steps:
       - name: Download all artifacts
@@ -240,17 +239,24 @@ jobs:
           find dist -name "*.whl" -exec cp {} all_wheels/ \;
           find dist -name "*.tar.gz" -exec cp {} all_wheels/ \;
           
+      - name: Show what will be published
+        run: |
+          echo "📦 Packages to be published:"
+          ls -la all_wheels/
+          
       - name: Publish to Test PyPI
-        if: github.event.inputs.publish == 'test' || github.event_name == 'workflow_dispatch'
+        if: github.event.inputs.publish == 'test'
         uses: pypa/gh-action-pypi-publish@release/v1
         with:
           password: ${{ secrets.TEST_PYPI_API_TOKEN }}
           repository-url: https://test.pypi.org/legacy/
           packages-dir: all_wheels/
+          skip-existing: true
           
       - name: Publish to PyPI
-        if: github.event_name == 'release' || github.event.inputs.publish == 'prod'
+        if: github.event.inputs.publish == 'prod'
         uses: pypa/gh-action-pypi-publish@release/v1
         with:
           password: ${{ secrets.PYPI_API_TOKEN }}
-          packages-dir: all_wheels/ 
+          packages-dir: all_wheels/
+          skip-existing: true 

.github/workflows/ci.yml

@@ -1,110 +0,0 @@
-name: CI - Build and Test
-
-on:
-  push:
-    branches: [ main ]
-  pull_request:
-    branches: [ main ]
-
-jobs:
-  build-test:
-    strategy:
-      matrix:
-        os: [ubuntu-latest, macos-latest]
-        python-version: ['3.9', '3.10', '3.11', '3.12', '3.13']
-    
-    runs-on: ${{ matrix.os }}
-    
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          submodules: recursive
-      
-      - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v5
-        with:
-          python-version: ${{ matrix.python-version }}
-      
-      - name: Install uv
-        run: |
-          curl -LsSf https://astral.sh/uv/install.sh | sh
-          echo "$HOME/.cargo/bin" >> $GITHUB_PATH
-      
-      - name: Install system dependencies (Ubuntu)
-        if: runner.os == 'Linux'
-        run: |
-          sudo apt-get update
-          sudo apt-get install -y libomp-dev libboost-all-dev libzmq3-dev \
-            pkg-config libopenblas-dev patchelf \
-            libaio-dev protobuf-compiler libprotobuf-dev libabsl-dev
-          
-          # Install Intel MKL for DiskANN
-          wget https://registrationcenter-download.intel.com/akdlm/IRC_NAS/79153e0f-74d7-45af-b8c2-258941adf58a/intel-onemkl-2025.0.0.940.sh
-          sudo sh intel-onemkl-2025.0.0.940.sh -a --components intel.oneapi.lin.mkl.devel --action install --eula accept -s
-          source /opt/intel/oneapi/setvars.sh
-          echo "MKLROOT=/opt/intel/oneapi/mkl/latest" >> $GITHUB_ENV
-          echo "LD_LIBRARY_PATH=/opt/intel/oneapi/mkl/latest/lib/intel64:$LD_LIBRARY_PATH" >> $GITHUB_ENV
-      
-      - name: Install system dependencies (macOS)
-        if: runner.os == 'macOS'
-        run: |
-          brew install libomp boost zeromq protobuf
-      
-      - name: Build all packages
-        run: |
-          echo "🔨 Building on ${{ matrix.os }} with Python ${{ matrix.python-version }}..."
-          export UV_SYSTEM_PYTHON=1
-          
-          # Verify Python version
-          python --version
-          which python
-          
-          # Build each package
-          for pkg in leann-core leann-backend-hnsw leann-backend-diskann leann; do
-            echo "Building $pkg..."
-            cd packages/$pkg
-            rm -rf dist/ build/ _skbuild/
-            # Use explicit python interpreter
-            uv build --wheel --python python
-            if [ ! -f dist/*.whl ]; then
-              echo "❌ Failed to build $pkg!"
-              exit 1
-            fi
-            echo "✅ $pkg built successfully"
-            cd ../..
-          done
-      
-      - name: Install and test packages
-        run: |
-          # Create clean test environment
-          python -m venv test_env
-          if [[ "$OSTYPE" == "msys" || "$OSTYPE" == "win32" ]]; then
-            source test_env/Scripts/activate
-          else
-            source test_env/bin/activate
-          fi
-          
-          # Install built packages
-          pip install packages/*/dist/*.whl
-          
-          # Basic import test
-          python -c "import leann; print('✅ LEANN imported successfully')"
-          python -c "import leann_backend_hnsw; print('✅ HNSW backend imported')"
-          python -c "import leann_backend_diskann; print('✅ DiskANN backend imported')"
-      
-      - name: Upload artifacts
-        uses: actions/upload-artifact@v4
-        with:
-          name: wheels-${{ matrix.os }}-py${{ matrix.python-version }}
-          path: packages/*/dist/*.whl
-          retention-days: 7
-  
-  # Summary job to ensure all builds pass
-  ci-success:
-    needs: build-test
-    runs-on: ubuntu-latest
-    steps:
-      - name: CI Success
-        run: |
-          echo "✅ All CI builds passed!"
-          echo "Ready for manual release when needed." 

.github/workflows/release-manual.yml

@@ -71,7 +71,7 @@ jobs:
           # Get the latest successful CI run on the previous commit (before version bump)
           COMMIT_SHA=$(git rev-parse HEAD~1)
           RUN_ID=$(gh run list \
-            --workflow="CI - Build and Test" \
+            --workflow="CI - Build Multi-Platform Packages" \
             --status=success \
             --commit=$COMMIT_SHA \
             --json databaseId \
@@ -93,13 +93,12 @@ jobs:
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
       
-      - name: Download artifacts from CI
+      - name: Download artifacts from CI run
         run: |
           echo "📦 Downloading artifacts from CI run ${{ steps.get-ci-run.outputs.run-id }}..."
           
-          # Download all wheel artifacts
+          # Download all artifacts (not just wheels-*)
           gh run download ${{ steps.get-ci-run.outputs.run-id }} \
-            --pattern "wheels-*" \
             --dir ./dist-downloads
           
           # Consolidate all wheels into packages/*/dist/
@@ -155,6 +154,34 @@ jobs:
           echo "To test installation:"
           echo "pip install -i https://test.pypi.org/simple/ leann"
       
+      - name: Publish to PyPI
+        env:
+          TWINE_USERNAME: __token__
+          TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
+        run: |
+          if [ -z "$TWINE_PASSWORD" ]; then
+            echo "❌ PYPI_API_TOKEN not configured!"
+            echo "   Please add PYPI_API_TOKEN to repository secrets"
+            exit 1
+          fi
+          
+          pip install twine
+          echo "📦 Publishing to PyPI..."
+          
+          # Collect all wheels in one place
+          mkdir -p all_wheels
+          find packages/*/dist -name "*.whl" -exec cp {} all_wheels/ \;
+          find packages/*/dist -name "*.tar.gz" -exec cp {} all_wheels/ \;
+          
+          echo "📋 Packages to publish:"
+          ls -la all_wheels/
+          
+          # Upload to PyPI
+          twine upload all_wheels/* --skip-existing --verbose
+          
+          echo "✅ Published to PyPI!"
+          echo "🎉 Check packages at: https://pypi.org/project/leann/"
+      
       - name: Create and push tag
         run: |
           git tag "v${{ inputs.version }}"
@@ -176,19 +203,4 @@ jobs:
             ### Installation
             ```bash
             pip install leann==${{ inputs.version }}
-            ```
-            
-            ### Test Installation (if using TestPyPI)
-            ```bash
-            pip install -i https://test.pypi.org/simple/ leann==${{ inputs.version }}
-            ```
-          draft: false
-          prerelease: false
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-      
-      - name: Trigger PyPI publish
-        run: |
-          echo "🚀 Triggering PyPI publish workflow..."
-          # The existing build-and-publish.yml will be triggered by the tag push
-          echo "✅ Release process completed! The publish workflow will run automatically." 
+            ```

docs/RELEASE.md

@@ -7,6 +7,14 @@ Before releasing, ensure:
 2. ✅ CI has passed on the latest commit (check [Actions](https://github.com/yichuan-w/LEANN/actions/workflows/ci.yml))
 3. ✅ You have determined the new version number
 
+### Required: PyPI Configuration
+
+To enable PyPI publishing:
+1. Get a PyPI API token from https://pypi.org/manage/account/token/
+2. Add it to repository secrets: Settings → Secrets → Actions → New repository secret
+   - Name: `PYPI_API_TOKEN`
+   - Value: Your PyPI token (starts with `pypi-`)
+
 ### Optional: TestPyPI Configuration
 
 To enable TestPyPI testing (recommended but not required):
@@ -29,12 +37,11 @@ To enable TestPyPI testing (recommended but not required):
 6. Click "Run workflow"
 
 **What happens:**
-- ✅ Validates version format
 - ✅ Downloads pre-built packages from CI (no rebuild needed!)
 - ✅ Updates all package versions
 - ✅ Optionally tests on TestPyPI
+- ✅ **Publishes directly to PyPI**
 - ✅ Creates tag and GitHub release
-- ✅ Automatically triggers PyPI publish
 
 ### Via Command Line
 
@@ -54,7 +61,7 @@ This script will:
 1. Update all package versions
 2. Commit and push changes
 3. Create GitHub release
-4. CI automatically builds and publishes to PyPI
+4. **Manual Release workflow will automatically publish to PyPI**
 
 ⚠️ **Note**: If CI fails, you'll need to manually fix and re-tag
 

packages/leann-backend-diskann/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "scikit_build_core.build"
 
 [project]
 name = "leann-backend-diskann"
-version = "0.1.1"
-dependencies = ["leann-core==0.1.0", "numpy"]
+version = "0.1.2"
+dependencies = ["leann-core==0.1.2", "numpy"]
 
 [tool.scikit-build]
 # Key: simplified CMake path

packages/leann-backend-hnsw/pyproject.toml

@@ -6,10 +6,10 @@ build-backend = "scikit_build_core.build"
 
 [project]
 name = "leann-backend-hnsw"
-version = "0.1.1"
+version = "0.1.2"
 description = "Custom-built HNSW (Faiss) backend for the Leann toolkit."
 dependencies = [
-    "leann-core==0.1.0", 
+    "leann-core==0.1.2", 
     "numpy",
     "pyzmq>=23.0.0",
     "msgpack>=1.0.0",

packages/leann-core/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "leann-core"
-version = "0.1.1"
+version = "0.1.2"
 description = "Core API and plugin system for LEANN"
 readme = "README.md"
 requires-python = ">=3.9"

packages/leann/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "leann"
-version = "0.1.1"
+version = "0.1.2"
 description = "LEANN - The smallest vector index in the world. RAG Everything with LEANN!"
 readme = "README.md"
 requires-python = ">=3.9"

scripts/bump_version.sh

@@ -7,12 +7,25 @@ fi
 
 NEW_VERSION=$1
 
+# Get the directory where the script is located
+SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
+PROJECT_ROOT="$( cd "$SCRIPT_DIR/.." && pwd )"
+
 # Update all pyproject.toml files
+echo "Updating versions in $PROJECT_ROOT/packages/"
+
 # Use different sed syntax for macOS vs Linux
 if [[ "$OSTYPE" == "darwin"* ]]; then
-    sed -i '' "s/version = \".*\"/version = \"$NEW_VERSION\"/" packages/*/pyproject.toml
+    # Update version fields
+    find "$PROJECT_ROOT/packages" -name "pyproject.toml" -exec sed -i '' "s/version = \".*\"/version = \"$NEW_VERSION\"/" {} \;
+    # Update leann-core dependencies
+    find "$PROJECT_ROOT/packages" -name "pyproject.toml" -exec sed -i '' "s/leann-core==[0-9.]*/leann-core==$NEW_VERSION/" {} \;
 else
-    sed -i "s/version = \".*\"/version = \"$NEW_VERSION\"/" packages/*/pyproject.toml
+    # Update version fields
+    find "$PROJECT_ROOT/packages" -name "pyproject.toml" -exec sed -i "s/version = \".*\"/version = \"$NEW_VERSION\"/" {} \;
+    # Update leann-core dependencies
+    find "$PROJECT_ROOT/packages" -name "pyproject.toml" -exec sed -i "s/leann-core==[0-9.]*/leann-core==$NEW_VERSION/" {} \;
 fi
 
-echo "Version updated to $NEW_VERSION" 
+echo "✅ Version updated to $NEW_VERSION"
+echo "✅ Dependencies updated to use leann-core==$NEW_VERSION"