Set default exercise router repo

README.md

@@ -265,8 +265,9 @@ comparison or fallback.
 
 To publish and load the router from Hugging Face, use the setup notes in
 [docs/huggingface-router-release.md](docs/huggingface-router-release.md). The draft model card is in
-[docs/huggingface-router-model-card.md](docs/huggingface-router-model-card.md). The current model
-repository is `NLag/pozify-exercise-router`.
+[docs/huggingface-router-model-card.md](docs/huggingface-router-model-card.md). Runtime loading uses
+`build-small-hackathon/pozify-exercise-router` by default; set `POZIFY_ROUTER_HF_REPO_ID` only to
+override it.
 
 Custom unknown clips can be uploaded into the data volume at `/data/raw/custom_unknown/` before the
 `features` stage. Use consented clips only; useful unknown examples include idle standing, walking

docs/huggingface-router-model-card.md

@@ -88,10 +88,11 @@ Summary:
 
 ## Runtime Loading
 
-Pozify can load this repository by setting:
+Pozify loads this repository by default. Set `POZIFY_ROUTER_HF_REPO_ID` only to override the default
+with another compatible router repo:
 
 ```bash
-export POZIFY_ROUTER_HF_REPO_ID=NLag/pozify-exercise-router
+export POZIFY_ROUTER_HF_REPO_ID=owner/other-pozify-router
 ```
 
 For private repositories, authenticate with `hf auth login` or set `HF_TOKEN`.

docs/huggingface-router-release.md

@@ -15,7 +15,7 @@ Official references:
 The configured model repository is:
 
 ```text
-NLag/pozify-exercise-router
+build-small-hackathon/pozify-exercise-router
 ```
 
 Create a user access token at:
@@ -53,7 +53,7 @@ Upload the model card and artifacts:
 
 ```bash
 uv run python scripts/upload_exercise_router_to_hf.py \
-  --repo-id NLag/pozify-exercise-router \
+  --repo-id build-small-hackathon/pozify-exercise-router \
   --private
 ```
 
@@ -69,10 +69,11 @@ The upload script creates the repository if needed and uploads:
 
 ## Runtime Configuration
 
-Set the model repository ID for runtime loading:
+The runtime loader uses `build-small-hackathon/pozify-exercise-router` by default. Override the
+model repository ID only when you want to test or deploy a different router repo:
 
 ```bash
-export POZIFY_ROUTER_HF_REPO_ID=NLag/pozify-exercise-router
+export POZIFY_ROUTER_HF_REPO_ID=owner/other-pozify-router
 ```
 
 Optional:
@@ -82,8 +83,8 @@ export POZIFY_ROUTER_HF_REVISION=main
 ```
 
 For private repositories, authenticate with `uv run hf auth login` or set `HF_TOKEN` before running
-the app. The loader first tries Hugging Face when `POZIFY_ROUTER_HF_REPO_ID` is set. If Hub loading
-fails or the variable is unset, it falls back to local files under `models/exercise_router/active/`.
+the app. The loader first tries Hugging Face using the default repo or the override above. If Hub
+loading fails, it falls back to local files under `models/exercise_router/active/`.
 
 Disable Hub loading explicitly:
 

src/pozify/ml/exercise_router_inference.py

@@ -14,6 +14,7 @@ from pozify.ml.exercise_router_temporal import TorchTemporalRouter
 
 DEFAULT_MODEL_DIR = Path("models/exercise_router/active")
 ACTIVE_SELECTION_FILENAME = "router_selection.json"
+DEFAULT_HF_REPO_ID = "build-small-hackathon/pozify-exercise-router"
 HF_REPO_ID_ENV = "POZIFY_ROUTER_HF_REPO_ID"
 HF_REVISION_ENV = "POZIFY_ROUTER_HF_REVISION"
 HF_DISABLE_ENV = "POZIFY_ROUTER_DISABLE_HF"
@@ -84,7 +85,7 @@ def load_router_model_from_hf(
     if _env_truthy(os.getenv(HF_DISABLE_ENV)):
         return None
 
-    repo_id = repo_id or os.getenv(HF_REPO_ID_ENV)
+    repo_id = repo_id or os.getenv(HF_REPO_ID_ENV) or DEFAULT_HF_REPO_ID
     if not repo_id:
         return None
 

tests/test_exercise_classifier.py

@@ -2,6 +2,7 @@ from __future__ import annotations
 
 import json
 import math
+import os
 from pathlib import Path
 import sys
 import tempfile
@@ -22,6 +23,8 @@ from pozify.ml.exercise_router_features import (
     window_vector_feature_names,
 )
 from pozify.ml.exercise_router_inference import (
+    DEFAULT_HF_REPO_ID,
+    HF_DISABLE_ENV,
     RouterModelBundle,
     WindowRouterPrediction,
     aggregate_window_predictions,
@@ -210,7 +213,8 @@ class ExerciseRouterModelLoadingTests(unittest.TestCase):
                 encoding="utf-8",
             )
 
-            bundle = load_router_model(model_dir)
+            with patch.dict(os.environ, {HF_DISABLE_ENV: "1"}):
+                bundle = load_router_model(model_dir)
 
         self.assertIsNotNone(bundle)
         assert bundle is not None
@@ -258,6 +262,43 @@ class ExerciseRouterModelLoadingTests(unittest.TestCase):
         self.assertEqual(bundle.model_kind, "baseline")
         self.assertEqual(bundle.labels, tuple(ROUTER_LABELS))
 
+    def test_hf_loader_defaults_to_pozify_router_repo(self) -> None:
+        with tempfile.TemporaryDirectory() as temp_dir:
+            model_dir = Path(temp_dir)
+            artifact_path = model_dir / "router.joblib"
+            selection_path = model_dir / "router_selection.json"
+            joblib.dump(
+                {
+                    "model": _FakePushUpModel(),
+                    "labels": list(ROUTER_LABELS),
+                    "model_kind": "baseline",
+                },
+                artifact_path,
+            )
+            selection_path.write_text(
+                json.dumps({"selected_artifact": artifact_path.name}),
+                encoding="utf-8",
+            )
+
+            def fake_download(*, repo_id: str, filename: str, revision: str | None) -> Path:
+                self.assertEqual(repo_id, DEFAULT_HF_REPO_ID)
+                self.assertIsNone(revision)
+                return {"router_selection.json": selection_path, "router.joblib": artifact_path}[filename]
+
+            with (
+                patch.dict(os.environ, {}, clear=True),
+                patch(
+                    "pozify.ml.exercise_router_inference._hf_hub_download",
+                    side_effect=fake_download,
+                ),
+            ):
+                bundle = load_router_model_from_hf()
+
+        self.assertIsNotNone(bundle)
+        assert bundle is not None
+        self.assertEqual(bundle.model_kind, "baseline")
+        self.assertEqual(bundle.labels, tuple(ROUTER_LABELS))
+
 
 class ExerciseClassifierStepTests(unittest.TestCase):
     def test_manual_override_bypasses_model_and_validates_contract(self) -> None:
@@ -274,12 +315,13 @@ class ExerciseClassifierStepTests(unittest.TestCase):
 
     def test_missing_model_falls_back_to_unknown(self) -> None:
         with tempfile.TemporaryDirectory() as temp_dir:
-            result = exercise_classifier.run(
-                _sequence("push_up"),
-                _profile("auto"),
-                mock=False,
-                model_dir=Path(temp_dir),
-            )
+            with patch.dict(os.environ, {HF_DISABLE_ENV: "1"}):
+                result = exercise_classifier.run(
+                    _sequence("push_up"),
+                    _profile("auto"),
+                    mock=False,
+                    model_dir=Path(temp_dir),
+                )
 
         self.assertEqual(result.exercise, "unknown")
         self.assertTrue(result.fallback_required)