NLP Research Repo Package Installment
When reproducing an NLP research repo, always align the environment to the repo's declared dependencies first. Most failures come from Python version mismatch or installing packages without following requirements.txt / environment.yml.
Mandatory preflight
Before any of the steps below, read and execute the workflow described in the companion file REPRODUCIBILITY_PREFLIGHT.md, which lives in the same folder as this SKILL.md. That preflight is part of this skill; do not skip it, and do not reorder it after the install steps.
What to do (must run before any install)
- Read the repo dependency files
- Prefer
environment.yml/environment.yaml - Otherwise use
requirements.txt - If both exist, treat
environment.ymlas the base,requirements.txtas supplemental unless README says otherwise
- Log the current environment (Python version is critical)
Write
/root/python_int.txtcontaining:
python -VVpython -m pip --versionpython -m pip freeze
- Compare & decide
- If the repo expects a specific Python major/minor and the current Python does not match, set up a matching environment before installing dependencies.
- Prefer installing from the repo's dependency files (avoid random upgrades), then run a quick import/smoke test.