CHANGELOG.md

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.
• Kanban patch exits with code 1 — entire kanban migration patch now wrapped in try/except; any unexpected error (file encoding, permission, changed upstream structure) skips silently instead of failing the Docker build.

0.2.0 - 2026-05-19

Features

• ENV Builder — interactive UI at /env-builder for configuring all Space secrets. Grouped sections: Core, Backup, Telegram, Terminal, Providers, Cloudflare, Advanced. Model picker with provider/model-name presets. Import/export as HUGGINGMES_ENV_BUNDLE or plain .env.
• JupyterLab terminal — full shell access at /terminal/. On by default (DEV_MODE=true). Uses GATEWAY_TOKEN as terminal password — no separate JUPYTER_TOKEN needed. Dashboard button added.
• Chromium browser tools — installs Chromium and display/font libs so Hermes browser-use tools work out of the box.
• Plugin persistence — Hermes plugin directory symlinked into the persistent volume; plugins survive container restarts.
• Secret redaction — enabled by default in Hermes config (security.redact_secrets: true).
• Cloudflare Keepalive — Cloudflare Worker setup for automatic space keep-awake.

Fixes

• Space stuck at RUNNING_APP_STARTING — root cause: start_jupyter() called python3 -c "import jupyterlab" using system Python; JupyterLab is installed in the Hermes venv. Import failed → return 1 → set -euo pipefail killed start.sh → container crashed every boot. Fixed to use /opt/hermes/.venv/bin/python.
• Terminal double password prompt — proxy now injects Authorization: token <JUPYTER_TOKEN> header when forwarding requests to JupyterLab, bypassing its own login screen. One login instead of two.
• Gemini 404 errors — strip google/ or gemini/ prefix when setting Hermes model name; Hermes gemini provider expects bare model name (e.g. gemini-2.5-flash, not google/gemini-2.5-flash).
• Config persistence — use setdefault for user-configurable fields; always overwrite model.default and model.provider from env so deploy-time settings win without clobbering dashboard changes.
• Keys disappearing after restart — sync state to HF Dataset on natural gateway exit (in addition to periodic sync and SIGTERM path).
• Sync timeouts — set HF_HUB_DOWNLOAD_TIMEOUT=300 and enable HF_XET_HIGH_PERFORMANCE for faster dataset transfers.
• hermes not found in terminal — symlink hermes CLI into $HERMES_HOME/.local/bin; add /etc/profile.d/hermes-venv.sh so PATH includes venv bin in all shell types.
• Kanban migration crash — wrap ALTER TABLE ADD COLUMN in try/except; idempotent on existing databases.
• Health endpoint returning 503 — /health always returns HTTP 200 (gateway status in JSON body). Returning 503 when gateway was starting caused Docker HEALTHCHECK to fail indefinitely.

Changes

• Space emoji updated to 🪽 (Hermes winged sandals) across README and dashboard.
• Login page redesigned to match HuggingClaw dark-card aesthetic.
• ENV Builder, Terminal, and Control UI all require session auth (single GATEWAY_TOKEN login).
• HF_HUB_ENABLE_HF_TRANSFER (deprecated) replaced with HF_XET_HIGH_PERFORMANCE=1.
• HEALTHCHECK start-period tuned to 60s; health endpoint always returns 200.

0.1.0 - 2026-05-03

• Initial HuggingMes Docker Space wrapper for Nous Research Hermes Agent.
• Added HF Space dashboard, /health, /status, /v1/* proxy, and Telegram webhook proxy.
• Added Cloudflare Worker setup for Telegram Bot API base URL proxying.
• Added private HF Dataset backup and restore for Hermes state.
• Added Cloudflare Keepalive Worker setup for automatic space keep-awake.