Help please - Updating my odysseus build also seems to have removed my optional-requirements despite it being visible.

[Stressed-Out09]

So I'm newish to using docker via cli (was using docker desktop before as i'm running linux so gpu wasn't couldn't be visible properly)
And after restarting my PC my Odysseus containers didn't startup. So I ran
docker compose up -d --build
and it spits out as normal (this is me rerunning it, took longer when I did it):

And now these things are broken: STT, TTS, Viewing PDFs, and I'm assuming something has broken with the optional requirements.

Can anybody help me out with fixing this or should I once again rebuild from scratch?

[VectorPeak]

Your screenshot pretty much shows the problem: the optional requirements file is copied into the image, but the install branch is disabled.

This line is the important one:

RUN pip install --no-cache-dir -r requirements.txt && if [ "false" = "true" ]; then pip install --no-cache-dir -r requirements-optional.txt; fi

Because that says "false" = "true", Docker skipped requirements-optional.txt. The file being visible in the build output only means it was copied into the image layer; it does not mean pip installed it. The CACHED [5/9] bit also suggests Docker reused the old dependency layer, so rerunning docker compose up -d --build didn’t necessarily change the optional dependency state.

You probably do not need to rebuild from scratch or wipe your data. Rebuild just the Odysseus image with the optional build arg enabled:

cd /path/to/odysseus

docker compose build --no-cache --build-arg INSTALL_OPTIONAL=true odysseus
docker compose up -d

After that, check that the optional packages are actually present inside the running container:

docker compose exec odysseus python -m pip show PyMuPDF duckduckgo-search

For PDF viewing specifically, PyMuPDF / fitz is the one I’d expect to matter. You can also test the import directly:

docker compose exec odysseus python - <<'PY'
import importlib.util

for name in ("fitz", "duckduckgo_search"):
 print(name, "OK" if importlib.util.find_spec(name) else "MISSING")
PY

If you want this to survive future docker compose up -d --build runs, it’s better to make it persistent in docker-compose.yml instead of relying on the CLI flag each time. Change the Odysseus service from the short form:

build: .

to:

build:
 context: .
 args:
 INSTALL_OPTIONAL: "true"

Then future rebuilds can just be:

docker compose up -d --build

Not sure STT/TTS are definitely from the same optional-requirements issue, worth checking separately. PDF viewing lines up with the skipped optional install, but STT/TTS may also depend on configured providers, local model setup, env vars, or a package that failed/imported differently after the update. The fastest way to separate those is to look at the app logs after the optional rebuild:

docker compose logs --tail=200 odysseus

If it still fails after rebuilding with INSTALL_OPTIONAL=true, paste the last ~100-200 lines from docker compose logs odysseus, plus the build: section of your docker-compose.yml. The logs will show whether this is still a missing Python module, while the compose snippet will confirm whether the build arg is actually being passed. Also avoid docker compose down -v unless you intentionally want to remove volumes/data.

---

If my answer solved your problem, you can click answered the question. I'm really here to help, and along the way I'm also collecting Galaxy Brain badges haha 😆