Skip to content

fix(agent-image): ship the uv binary in the runtime stage (#68) #88

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
stubbi merged 1 commit into from
Jun 18, 2026
Merged

fix(agent-image): ship the uv binary in the runtime stage (#68) #88

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 13 additions & 0 deletions images/hermes-agent/Dockerfile
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -96,9 +96,22 @@ COPY --from=builder --chown=hermes:hermes /opt/venv /opt/venv
# no HermesInstance ever reaches Ready. See #68.
COPY --from=builder --chown=hermes:hermes /build/pyproject.toml /build/uv.lock /opt/venv-template/

# Ship the uv binary in the runtime image too. The operator's `init-uv` init
# container runs `uv sync --frozen` (above) to materialise the env onto the
# per-instance PVC, so uv must be on PATH at runtime — the resolved venv at
# /opt/venv does not include uv. Without this, init-uv exits 127
# ("uv: not found") and no HermesInstance reaches Ready. See #68.
COPY --from=uv /uv /uvx /usr/local/bin/

# UV_* defaults for the init-uv `uv sync` at pod start: pin a deterministic
# interpreter and a PVC-safe link mode so uv never tries to download a Python or
# hardlink across filesystems (image layer -> mounted PVC).
ENV PATH="/opt/venv/bin:${PATH}" \
PYTHONUNBUFFERED=1 \
PYTHONDONTWRITEBYTECODE=1 \
UV_PYTHON_DOWNLOADS=never \
UV_PYTHON=/usr/local/bin/python \
UV_LINK_MODE=copy \
HOME=/home/hermes

# Image metadata. The HERMES_VERSION label is the one the operator's autoupdate
Expand Down
Loading