fix: resolve Docker build failures by handling library renaming, pinning JupyterLab dependencies, and using explicit binary paths

CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.2.1 - 2026-05-20
+
+### Fixes
+
+- **Build fails after update** — `libasound2` renamed to `libasound2t64` in Debian bookworm. Dockerfile now tries both names, falling back gracefully so builds succeed on all base image variants.
+- **Unpinned jupyterlab breaks venv** — `uv pip install jupyterlab` without a version constraint could pull a release incompatible with existing Hermes venv packages. Pinned to `>=4.0,<5` range to bound resolution.
+- **`uv` not in PATH during Docker build** — switched from bare `uv` to explicit `/opt/hermes/.venv/bin/uv` so the install works regardless of base image PATH configuration.
+- **`visudo` not in PATH during Docker build** — switched to explicit `/usr/sbin/visudo` path.
+
 ## 0.2.0 - 2026-05-19
 
 ### Features

Dockerfile

@@ -26,15 +26,22 @@ RUN apt-get update && apt-get install -y --no-install-recommends \
     libx11-6 \
     libxext6 \
     libxfixes3 \
-    libasound2 \
     fonts-dejavu-core \
     fonts-liberation \
     fonts-noto-color-emoji \
+    && (apt-get install -y --no-install-recommends libasound2 2>/dev/null \
+        || apt-get install -y --no-install-recommends libasound2t64 2>/dev/null \
+        || true) \
     && rm -rf /var/lib/apt/lists/* \
-    && uv pip install --python /opt/hermes/.venv/bin/python --no-cache-dir huggingface_hub hf_transfer jupyterlab \
+    && /opt/hermes/.venv/bin/uv pip install --no-cache-dir \
+        huggingface_hub \
+        hf_transfer \
+        "jupyterlab>=4.0,<5" \
+        "tornado>=6.4" \
+        "ipywidgets>=8.1" \
     && printf 'hermes ALL=(ALL) NOPASSWD: ALL\n' > /etc/sudoers.d/hermes \
     && chmod 0440 /etc/sudoers.d/hermes \
-    && visudo -cf /etc/sudoers.d/hermes
+    && /usr/sbin/visudo -cf /etc/sudoers.d/hermes
 
 COPY --chown=hermes:hermes start.sh /opt/huggingmes/start.sh
 COPY --chown=hermes:hermes health-server.js /opt/huggingmes/health-server.js