feat: add devcontainer based setup docs

scripts/setup_requirements.sh

@@ -32,6 +32,26 @@ DOGRAH_DIR="$(dirname "$SCRIPT_DIR")"
 
 cd "$DOGRAH_DIR"
 
+# Fail early if the active Python is not 3.12 or 3.13. uv pip installs into
+# whichever interpreter resolves here (the active venv, or PATH python3), so a
+# mismatch surfaces as confusing wheel/build errors much later.
+PYTHON_BIN="${PYTHON:-python3}"
+if ! command -v "$PYTHON_BIN" >/dev/null 2>&1; then
+    echo "Error: '$PYTHON_BIN' not found on PATH." >&2
+    echo "Activate the project venv (or set PYTHON=/path/to/python) and retry." >&2
+    exit 1
+fi
+
+PY_MAJ_MIN=$("$PYTHON_BIN" -c 'import sys; print(f"{sys.version_info.major}.{sys.version_info.minor}")')
+case "$PY_MAJ_MIN" in
+    3.12|3.13) ;;
+    *)
+        echo "Error: Python 3.12 or 3.13 required, found $PY_MAJ_MIN at $(command -v "$PYTHON_BIN")." >&2
+        echo "Activate a venv built with python3.12 or python3.13 and retry." >&2
+        exit 1
+        ;;
+esac
+
 echo "Setting up pipecat as a git submodule..."
 
 if [ "$DEV_MODE" -eq 0 ]; then