How to install packages in Agent Mode?

[KinWaiCheuk]

In Agent Mode, the LLM will run some commands such as python, ls, and etc.
But from time to time, there are packages that are not installed.

For example unzip. Which fails with the message

STDERR: /bin/sh: 1: unzip: not found

I do have unzip installed in my host, but it is missing in the docker container.
How to install missing packages for the Agent to use?

[dfbustosus]

Host packages are not visible inside the Agent container. The current image is based on python:3.14-slim, and unzip is absent from its final-stage package list. INSTALL_OPTIONAL only installs optional Python requirements; it does not add Debian packages.

The durable solution is to add unzip to the final-stage apt-get install list in the project Dockerfile, then rebuild:

docker compose up -d --build --force-recreate odysseus
docker compose exec odysseus unzip -v

Commit that Dockerfile change in a fork or maintained branch so updates remain reproducible. A temporary installation is possible:

docker compose exec --user root odysseus sh -lc "apt-get update && apt-get install -y --no-install-recommends unzip && rm -rf /var/lib/apt/lists/*"

That survives a restart of the same container but is lost when it is rebuilt or recreated. Do not give Agent Mode permanent root access; bake approved tools into the image instead.

For ZIP extraction specifically, Python is already present and may be enough without another package:

python -m zipfile -e archive.zip destination/

The project itself uses Python zipfile as a fallback when unzip and bsdtar are absent: source.