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, run the sibling preflight script preflight_notes.sh
shipped in this skill directory:
bash /root/.claude/skills/nlp-research-repo-package-installment/preflight_notes.sh
It normalizes the reproducibility notes header (version NLP-REPRO-TEMPLATE-v2)
so downstream log readers can cross-reference runs across repos.
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.