Standardize examples and error messages with uv CLI for virtual env. and dependency installation (#2129)

examples/count_people_in_zone/README.md

@@ -24,14 +24,14 @@ https://github.com/roboflow/supervision/assets/26109316/f84db7b5-79e2-4142-a1da-
 - setup python environment and activate it [optional]
 
     ```bash
-    python3 -m venv venv
-    source venv/bin/activate
+    uv venv
+    source .venv/bin/activate
     ```
 
 - install required dependencies
 
     ```bash
-    pip install -r requirements.txt
+    uv pip install -r requirements.txt
     ```
 
 - download `traffic_analysis.pt` and `traffic_analysis.mov` files

examples/heatmap_and_track/README.md

@@ -18,14 +18,14 @@ supervision package for multiple tasks such as drawing heatmap annotations, trac
 - setup python environment and activate it [optional]
 
     ```bash
-    python3 -m venv venv
-    source venv/bin/activate
+    uv venv
+    source .venv/bin/activate
     ```
 
 - install required dependencies
 
     ```bash
-    pip install -r requirements.txt
+    uv pip install -r requirements.txt
     ```
 
 ## 🛠️ script arguments

examples/speed_estimation/README.md

@@ -29,20 +29,20 @@ https://github.com/roboflow/supervision/assets/26109316/d50118c1-2ae4-458d-915a-
 - setup python environment and activate it [optional]
 
     ```bash
-    python3.10 -m venv venv
-    source venv/bin/activate
+    uv venv
+    source .venv/bin/activate
     ```
 
 - install required dependencies
 
     ```bash
-    pip install -r requirements.txt
+    uv pip install -r requirements.txt
     ```
 
 - download `vehicles.mp4` file
 
     ```bash
-    python3.10 video_downloader.py
+    python video_downloader.py
     ```
 
 ## 🛠️ script arguments

examples/time_in_zone/README.md

@@ -23,14 +23,14 @@ https://github.com/roboflow/supervision/assets/26109316/d051cc8a-dd15-41d4-aa36-
 - setup python environment and activate it [optional]
 
     ```bash
-    python3 -m venv venv
-    source venv/bin/activate
+    uv venv
+    source .venv/bin/activate
     ```
 
 - install required dependencies
 
     ```bash
-    pip install -r requirements.txt
+    uv pip install -r requirements.txt
     ```
 
 ## 🛠 scripts

examples/tracking/README.md

@@ -17,14 +17,14 @@ detection and Supervision for tracking and annotation.
 - setup python environment and activate it [optional]
 
     ```bash
-    python3 -m venv venv
-    source venv/bin/activate
+    uv venv
+    source .venv/bin/activate
     ```
 
 - install required dependencies
 
     ```bash
-    pip install -r requirements.txt
+    uv pip install -r requirements.txt
     ```
 
 ## 🛠️ script arguments

examples/traffic_analysis/README.md

@@ -20,14 +20,14 @@ https://github.com/roboflow/supervision/assets/26109316/c9436828-9fbf-4c25-ae8c-
 - setup python environment and activate it [optional]
 
     ```bash
-    python3 -m venv venv
-    source venv/bin/activate
+    uv venv
+    source .venv/bin/activate
     ```
 
 - install required dependencies
 
     ```bash
-    pip install -r requirements.txt
+    uv pip install -r requirements.txt
     ```
 
 - download `traffic_analysis.pt` and `traffic_analysis.mov` files

supervision/metrics/utils/utils.py

@@ -4,7 +4,6 @@ def ensure_pandas_installed() -> None:
     except ImportError:
         raise ImportError(
             "`metrics` extra is required to run the function."
-            " Run `pip install 'supervision[metrics]'` or"
-            " `poetry add supervision -E metrics` or"
-            " `uv pip install 'supervision[metrics]'`"
+            " Run `uv pip install 'supervision[metrics]'` or"
+            " `uv add supervision --extra metrics`."
         )