Use Python Virtual Environments In Termux

Use This Guide When

Before You Run Anything

• Copy the complete error, including the first package, file, module, or line number it names.
• Record `termux-info`, the active language/runtime version, and the current folder before changing dependencies.
• Do not delete package-manager locks or upgrade pip itself through pip in Termux.

Diagnostic Or Setup Commands

A virtual environment isolates project libraries, but Termux still supplies the base Python and packaged pip.

pkg install -y python python-pip
python -m venv ~/venvs/project1
source ~/venvs/project1/bin/activate
python -m pip install --upgrade setuptools wheel
python -m pip install requests
python -c "import requests; print(requests.__version__)"

What The Commands Tell You

• `pkg install -y python python-pip` — Installs the listed Termux packages and dependencies.
• `python -m venv ~/venvs/project1` — Creates an isolated Python environment for one project.
• `python -m pip install --upgrade setuptools wheel` — Installs or updates the named Python distribution, not pip itself.
• `python -c "import requests; print(requests.__version__)"` — Runs a small isolated Python test.

What Success Looks Like

• The minimal version, import, syntax, path, or package test exits successfully.
• The original command now fails later for a different, clearly identified reason or completes normally.
• The package manager has no interrupted configuration left pending.

Safe Next Steps

1. Repair or update the Termux package layer before retrying a language package.
2. Confirm that the interpreter and its package tool belong to the same installation.
3. Install the missing system dependency before repeating a Python or Node build.
4. Retest with a minimal version, import, compile, or file command before running the full script.

Common Mistakes

• Using `sudo`, Ubuntu package names, or desktop paths in a normal Termux installation.
• Assuming that a Python import name always matches the distribution name on PyPI.
• Deleting caches, environments, or lock files before preserving the exact error and versions.