Skip to content

`mkdocs build` command fails when running `make run`

When I do make run as instructed in the README, the Make process tries to call mkdocs build, which fails with the following error:

mkdocs build
make: mkdocs: No such file or directory
make: *** [site/index.html] Error 1

This appears to be because mkdocs build doesn't refer to the copy of mkdocs in the local environment, unlike similar commands in the Makefile which are prefix with .venv/bin/ to solve this. Adding this to the command in the Makefile solves this, but then I get:

  File "/Users/admin/Desktop/work/opentechstrategies/llm-api/.venv/lib/python3.10/site-packages/mkdocstrings_handlers/python/handler.py", line 15, in <module>
    from griffe.collections import LinesCollection, ModulesCollection
ModuleNotFoundError: No module named 'griffe.collections'

This appears to be a mkdocs version mismatch with a dependency (griffe released a new version with a different API), which is solvable by upgrading mkdocstrings-python to 1.10.8.

You should expect an MR with both changes shortly.