Add PEP 723 metadata so that Python scripts can be invoked with uv run

scripts/compare_encoder.py

@@ -1,3 +1,8 @@
+#!/usr/bin/env python3
+# /// script
+# requires-python = ">=3.10"
+# dependencies = ["torch", "numpy", "safetensors"]
+# ///
 """Compare C++ encoder intermediate outputs with PyTorch reference.
 Uses same weights from safetensors to build PyTorch reference.
 """

scripts/compare_features.py

@@ -1,3 +1,8 @@
+#!/usr/bin/env python3
+# /// script
+# requires-python = ">=3.10"
+# dependencies = ["torch", "torchaudio", "numpy"]
+# ///
 """Compare C++ and Python mel features with NeMo-compatible preprocessing."""
 import torch
 import torchaudio

scripts/convert_nemo.py

@@ -1,4 +1,8 @@
 #!/usr/bin/env python3
+# /// script
+# requires-python = ">=3.10"
+# dependencies = ["torch", "safetensors", "packaging", "numpy"]
+# ///
 """Convert NeMo Parakeet checkpoints to safetensors for axiom.
 
 Supported models:

scripts/debug_encoder.py

@@ -1,3 +1,8 @@
+#!/usr/bin/env python3
+# /// script
+# requires-python = ">=3.10"
+# dependencies = ["torch", "torchaudio", "numpy", "safetensors"]
+# ///
 """Compare C++ encoder output with PyTorch reference, layer by layer.
 Uses safetensors weights directly with PyTorch, no NeMo dependency.
 """

scripts/extract_vocab.py

@@ -1,4 +1,8 @@
 #!/usr/bin/env python3
+# /// script
+# requires-python = ">=3.10"
+# dependencies = []
+# ///
 """Extract SentencePiece vocabulary from a NeMo archive.
 
 Usage:

scripts/nemo_inference.py

@@ -1,4 +1,8 @@
 #!/usr/bin/env python3
+# /// script
+# requires-python = ">=3.10"
+# dependencies = ["torch", "numpy", "safetensors", "packaging"]
+# ///
 """Run NeMo inference for reference comparison."""
 import torch
 import numpy as np

scripts/pytorch_benchmark.py

@@ -1,4 +1,8 @@
 #!/usr/bin/env python3
+# /// script
+# requires-python = ">=3.10"
+# dependencies = ["torch", "pyyaml", "nemo_toolkit[asr]"]
+# ///
 """Benchmark PyTorch/NeMo inference for comparison with parakeet.cpp."""
 import os
 import sys