fix: update README PyPI install instructions and add release workflow

Author: matte1782

.github/workflows/release.yml

@@ -0,0 +1,82 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: read
+
+jobs:
+  build_wheels:
+    name: Build wheels on ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      # Host Rust installation (for Windows/macOS)
+      - name: Install Rust
+        if: runner.os != 'Linux'
+        run: |
+          rustup update stable
+
+      - name: Build wheels
+        uses: pypa/cibuildwheel@v2.16.5
+        env:
+          # Only build for Python 3.10+ as per pyproject.toml
+          CIBW_BUILD: "cp310-* cp311-* cp312-* cp313-*"
+          
+          # Target platforms
+          CIBW_ARCHS_LINUX: x86_64
+          CIBW_ARCHS_MACOS: x86_64 arm64
+          CIBW_ARCHS_WINDOWS: AMD64
+
+          # Linux: Install Rust in the manylinux/musllinux container
+          CIBW_BEFORE_ALL_LINUX: "curl https://sh.rustup.rs -sSf | sh -s -- -y --default-toolchain stable --profile minimal"
+          CIBW_ENVIRONMENT_LINUX: 'PATH="$PATH:$HOME/.cargo/bin"'
+          
+          # Build backend verification
+          CIBW_BUILD_FRONTEND: build
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: cibw-wheels-${{ matrix.os }}-${{ strategy.job-index }}
+          path: ./wheelhouse/*.whl
+
+  build_sdist:
+    name: Build source distribution
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Build sdist
+        run: pipx run build --sdist
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: cibw-sdist
+          path: dist/*.tar.gz
+
+  publish_to_pypi:
+    needs: [build_wheels, build_sdist]
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/binary-semantic-cache
+    permissions:
+      id-token: write  # IMPORTANT: Mandatory for trusted publishing
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          pattern: cibw-*
+          path: dist
+          merge-multiple: true
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+

README.md

@@ -31,13 +31,13 @@ Most semantic caches are slow (Python-only), heavy (require VectorDB), or comple
 
 ### 1. Installation
 
-**Prerequisites:** Python 3.10+ and Rust (for source build).
+**Prerequisites:** Python 3.10+. Rust is only needed for source builds.
 
 ```bash
-# Option A: From PyPI (Coming Soon)
-# pip install "binary-semantic-cache[openai]"
+# Option A: From PyPI (Recommended)
+pip install "binary-semantic-cache[openai]"
 
-# Option B: From Source (Recommended for Beta)
+# Option B: From Source (Development)
 git clone https://github.com/matte1782/binary_semantic_cache.git
 cd binary_semantic_cache
 pip install maturin