More changes stemming from pip to uv migration.

Author: normanlorrain

README.md

@@ -132,7 +132,7 @@ These scripts will:
 After adding an image to a post, run the optimization script to convert it to WebP and resize it for the web:
 
 ```bash
-python3 scripts/optimize_image.py docs/posts/YYYY/MM/DD/your_image.png
+uv run python scripts/optimize_image.py docs/posts/YYYY/MM/DD/your_image.png
 ```
 
 This will create an optimized `.webp` file alongside the original. Update your post's markdown to reference the new `.webp` file, then delete the original if no longer needed.
@@ -148,13 +148,13 @@ This will create an optimized `.webp` file alongside the original. Update your p
 
 ```bash
 # Optimize a single image with defaults
-python3 scripts/optimize_image.py docs/posts/2026/04/14/photo.png
+uv run python scripts/optimize_image.py docs/posts/2026/04/14/photo.png
 
 # Batch optimize multiple images
-python3 scripts/optimize_image.py docs/posts/2026/04/14/*.png docs/posts/2026/04/14/*.jpg
+uv run python scripts/optimize_image.py docs/posts/2026/04/14/*.png docs/posts/2026/04/14/*.jpg
 
 # Custom quality and max width
-python3 scripts/optimize_image.py --quality 90 --max-width 1600 image.jpeg
+uv run python scripts/optimize_image.py --quality 90 --max-width 1600 image.jpeg
 ```
 
 
@@ -167,27 +167,26 @@ To see all categories and tags currently in use, run:
 
 **Bash (Linux/macOS)**:
 ```bash
-python3 scripts/find_tags_categories.py
+uv run python scripts/find_tags_categories.py
 ```
 
 **PowerShell (Windows)**:
 ```powershell
-python scripts/find_tags_categories.py
+uv run python scripts/find_tags_categories.py
 ```
 
-This script requires `pyyaml`, which is included in `requirements.txt`. It is also run automatically by the `create_post` scripts when scaffolding a new post.
+This script requires `pyyaml`, which is included in the dev dependencies. It is also run automatically by the `create_post` scripts when scaffolding a new post.
 
 ## Project Structure
 
 ```
 .
 ├── mkdocs.yml                 # Main configuration file
-├── requirements.txt           # Python dependencies
+├── pyproject.toml             # Python dependencies + uv config
+├── uv.lock                    # Locked dependency tree
 ├── docker-compose.yml         # Docker development environment
 ├── create_post.sh             # Bash script to create blog posts
 ├── create_post.ps1            # PowerShell script to create blog posts
-├── requirements-dev.in         # Dev-only dependency pins (e.g. Pillow)
-├── requirements-dev.txt        # Compiled dev dependencies
 ├── scripts/
 │   ├── find_tags_categories.py # List all existing tags and categories
 │   └── optimize_image.py       # Optimize images for the web (PNG/JPEG → WebP)
@@ -221,15 +220,15 @@ mkdocs build                    # Build static site to site/ directory
 mkdocs build --clean            # Clean build
 
 # Optimize an image for the web
-python3 scripts/optimize_image.py docs/posts/YYYY/MM/DD/image.png
+uv run python scripts/optimize_image.py docs/posts/YYYY/MM/DD/image.png
 
 # Help
 mkdocs -h                       # Show help
 
 # Docker
 docker compose up app           # Start development server (with hot reloading)
 docker compose down             # Stop containers
-docker compose down -v          # Stop containers and remove volumes (pip cache)
+docker compose down -v          # Stop containers and remove volumes (uv cache)
 ```
 
 ## Deployment

scripts/optimize_image.py

@@ -27,10 +27,10 @@
 except ImportError:
     print(
         "Error: Pillow is not installed.\n"
-        "Install dev dependencies with:\n"
-        "  pip install -r requirements-dev.txt\n"
-        "Or install Pillow directly:\n"
-        "  pip install Pillow",
+        "Install the project dependencies with:\n"
+        "  uv sync\n"
+        "Then run this script with:\n"
+        "  uv run python scripts/optimize_image.py ...",
         file=sys.stderr,
     )
     sys.exit(1)