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

What to do (must run before any install)

1. 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.yml

  as the base,

  requirements.txt

  as supplemental unless README says otherwise

2. Log the current environment (Python version is critical)
   Write

   /root/python_int.txt

   containing:

• python -VV

  (required; Python version is often the root cause)

• python -m pip --version

• python -m pip freeze

3. Compare & decide

• If the repo expects a specific Python major/minor and the current Python does not match, it’s usually best to set up a matching environment before installing dependencies. Example: set up a fresh Python 3.11 environment (Docker / Ubuntu) with uv # Install uv apt-get update apt-get install -y --no-install-recommends curl ca-certificates rm -rf /var/lib/apt/lists/* curl -LsSf https://astral.sh/uv/0.9.7/install.sh | sh export PATH="/root/.local/bin:$PATH"

    # Install Python + create a venv
    uv python install 3.11.8
    uv venv --python 3.11.8 /opt/py311
  
    # Use the new Python for installs/runs
    /opt/py311/bin/python -VV
    /opt/py311/bin/python -m pip install -U pip setuptools wheel
  

• Prefer installing from the repo’s dependency files (avoid random upgrades), then run a quick import/smoke test.