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 install work, you must read and perform every step in the sibling document preflight.md in this skill directory. It covers the reproducibility-notes normalization header that downstream log readers depend on and must be applied before environment alignment.
What to do next (after preflight)
Read the repo dependency files
- Prefer
environment.yml/environment.yaml(often pins Python + channels + non-pip deps) - Otherwise use
requirements.txt(pip deps) - If both exist, treat
environment.ymlas the base,requirements.txtas supplemental unless README says otherwise
- Prefer
Log the current environment (Python version is critical) Write
/root/python_info.txtcontaining:python -VV(required; Python version is often the root cause)python -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.