docs(examples): switch Iceberg workflow to uv run

feast-dev · tommy-ca · Jan 13, 2026 · Jan 14, 2026 · Jan 14, 2026 · Jan 14, 2026
commit f4ce8433772cae38f66d21182a1151859b8bf9a8
@@ -37,10 +37,6 @@ In order to use this offline store, you'll need to install the Iceberg dependenc
 uv sync --extra iceberg
 ```
 
-Or if using pip:
-```bash
-pip install 'feast[iceberg]'
-```
 
 This installs:
 * `pyiceberg[sql,duckdb]>=0.8.0` - Native Iceberg table operations

@@ -41,10 +41,6 @@ In order to use this online store, you'll need to install the Iceberg dependenci
 uv sync --extra iceberg
 ```
 
-Or if using pip:
-```bash
-pip install 'feast[iceberg]'
-```
 
 This installs:
 * `pyiceberg[sql,duckdb]>=0.8.0` - Native Iceberg table operations

@@ -57,15 +57,13 @@ Welcome! This README provides a comprehensive guide to the Apache Iceberg storag
 # Install Feast with Iceberg support
 uv sync --extra iceberg
 
-# Or using pip
-pip install 'feast[iceberg]'
 ```
 
 ### Run Local Example
 
 ```bash
 cd examples/iceberg-local
-uv run python run_example.py
+PYTHONPATH=../../sdk/python uv run python run_example.py
 ```
 
 This will:

@@ -122,18 +122,20 @@ These are the **deterministic** steps to validate the initial certified matrix.
 Use the local end-to-end example:
 
 ```bash
+uv sync --extra iceberg
 cd examples/iceberg-local
-uv run python run_example.py
+PYTHONPATH=../../sdk/python uv run python run_example.py
 ```
 
 ### Certified: REST catalog + S3-compatible warehouse (MinIO / AWS S3)
 
 Use the REST+MinIO smoke stack and script:
 
 ```bash
+uv sync --extra iceberg
 cd examples/iceberg-rest-minio
 docker compose up -d
-PYTHONPATH=../../sdk/python python smoke_test.py
+PYTHONPATH=../../sdk/python uv run python smoke_test.py
 docker compose down -v
 ```
 

@@ -30,13 +30,6 @@ uv sync --extra iceberg
 # Or add to an existing project
 uv add "feast[iceberg]"
 ```
-
-### Using pip
-
-```bash
-pip install "feast[iceberg]"
-```
-
 This installs:
 - `pyiceberg[sql,duckdb]>=0.8.0` - Native Iceberg support
 - `duckdb>=1.0.0` - SQL engine for joins

@@ -17,12 +17,19 @@ This example shows:
 
 ## Installation
 
+This repo uses an **uv-native** workflow (no pip).
+
+From the repo root:
+
 ```bash
-# Install Feast with Iceberg support
-pip install feast[iceberg]
+uv sync --extra iceberg
+```
 
-# Or using uv (recommended)
-uv pip install feast[iceberg]
+Then run the example:
+
+```bash
+cd examples/iceberg-local
+PYTHONPATH=../../sdk/python uv run python run_example.py
 ```
 
 ## Project Structure
@@ -46,7 +53,7 @@ iceberg-local/
 Run the complete example:
 
 ```bash
-python run_example.py
+PYTHONPATH=../../sdk/python uv run python run_example.py
 ```
 
 This script will:
@@ -255,24 +262,23 @@ For production workloads, consider:
 ### PyArrow version conflicts
 ```bash
 # Ensure Python < 3.13
-python --version
+uv run python --version
 
 # Reinstall with explicit PyArrow version
-pip install pyarrow==15.0.0 feast[iceberg]
 ```
 
 ### Catalog errors
 ```bash
 # Remove and recreate catalog
 rm -rf data/
-python run_example.py
+PYTHONPATH=../../sdk/python uv run python run_example.py
 ```
 
 ### Import errors
 ```bash
 # Ensure you're in the example directory
 cd examples/iceberg-local
-python run_example.py
+PYTHONPATH=../../sdk/python uv run python run_example.py
 ```
 
 ## Next Steps

@@ -10,7 +10,7 @@
 5. Retrieving historical features (point-in-time correct)
 
 Requirements:
-    pip install feast[iceberg]
+    uv sync --extra iceberg
 """
 
 import os

@@ -15,7 +15,7 @@ It validates that Feast’s Iceberg offline/online store integrations can:
 ## Prerequisites
 
 - Docker + docker compose
-- Python with `pyiceberg`, `pyarrow`, and `duckdb` available
+- `uv` (run `uv sync --extra iceberg` from the repo root)
 
 From the Feast repo root, run the smoke test using the repo sources:
 
@@ -26,8 +26,11 @@ cd examples/iceberg-rest-minio
 
 docker compose up -d
 
-# Run smoke test against the REST catalog
-PYTHONPATH=../../sdk/python python smoke_test.py
+# Ensure dependencies are present
+uv sync --extra iceberg
+
+# Run smoke test against the REST catalog (use repo sources)
+PYTHONPATH=../../sdk/python uv run python smoke_test.py
 
 docker compose down -v
 ```