Skip to content

Make bin/evaluate and bin/probe_model_temperature run as documented - #192

Merged
adamjohnwright merged 1 commit into
mainfrom
fix/bin-scripts-run-as-documented
Sep 9, 2026
Merged

adamjohnwright merged 1 commit into
mainfrom
fix/bin-scripts-run-as-documented

Conversation

@adamjohnwright

Copy link
Copy Markdown
Contributor

Both scripts landed today carry a usage line that does not work:

$ ./bin/evaluate --help
ModuleNotFoundError: No module named 'evaluation'

Imports resolved in the Dockerfile (PYTHONPATH=/app/src) and in CI (./bin:./src) — and nowhere else. So the invocation printed in the README was the one configuration nobody had actually run. I found it by running the command as written rather than the PYTHONPATH=./src:./bin .venv/bin/python bin/evaluate I had been using while developing.

Each script now puts src/ on sys.path from its own location, so it works from any directory. poetry run is still needed for the interpreter, and the README says so.

bin/probe_model_temperature also treated --help as a model name and dutifully probed a model called --help. It prints its docstring now.

Verified: both --help invocations, and bin/evaluate run from /tmp.

Note the same pattern affects bin/retrieval_baseline and bin/embeddings_manager, whose docstrings show bare ./bin/... invocations too. Left alone here rather than widening the diff — worth a follow-up.

Both scripts landed today carrying a usage line -- `./bin/evaluate`,
`./bin/probe_model_temperature` -- that raises ModuleNotFoundError.
Imports resolved in the Dockerfile (PYTHONPATH=/app/src) and in CI
(./bin:./src) and nowhere else, so the documented invocation was the
one configuration nobody had run. Found by running the command in the
README rather than the one used while developing.

Each script now puts src/ on sys.path itself, from its own location,
so it works from any directory. poetry run is still needed for the
interpreter, and the README now says so.

bin/probe_model_temperature also took --help as a model name and
dutifully probed a model called "--help". It prints its docstring now.
@adamjohnwright
adamjohnwright merged commit 02e2968 into main Sep 9, 2026
10 checks passed
@adamjohnwright
adamjohnwright deleted the fix/bin-scripts-run-as-documented branch September 9, 2026 16:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant