[feat] add example scripts for transcription, model downloading, and updates; improve documentation with guides for CI, packaging, and development

examples/download_models_interactive.sh

@@ -0,0 +1,11 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Launch the interactive model downloader and select models to install
+
+BIN=${BIN:-./target/release/polyscribe}
+MODELS_DIR=${POLYSCRIBE_MODELS_DIR:-$PWD/models}
+export POLYSCRIBE_MODELS_DIR="$MODELS_DIR"
+
+mkdir -p "$MODELS_DIR"
+"$BIN" --download-models

examples/transcribe_file.sh

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Transcribe an audio/video file to JSON and SRT into ./output
+# Requires a model; first run may prompt to download.
+
+BIN=${BIN:-./target/release/polyscribe}
+INPUT=${1:-samples/example.mp3}
+OUTDIR=${OUTDIR:-output}
+
+mkdir -p "$OUTDIR"
+"$BIN" -v -o "$OUTDIR" "$INPUT"
+echo "Done. See $OUTDIR for JSON/SRT files."

examples/update_models.sh

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Verify/update local models non-interactively (useful in CI)
+
+BIN=${BIN:-./target/release/polyscribe}
+MODELS_DIR=${POLYSCRIBE_MODELS_DIR:-$PWD/models}
+export POLYSCRIBE_MODELS_DIR="$MODELS_DIR"
+
+mkdir -p "$MODELS_DIR"
+"$BIN" --update-models --no-interaction -q
+
+echo "Models updated in $MODELS_DIR"