Termux is a powerful Android terminal environment, but beginners
sometimes encounter errors when installing Python, pip, packages, libraries or
command-line tools. Errors such as Unable to locate package,
Could not build wheels, ModuleNotFoundError,
repository errors and broken dependencies can make installation confusing.
This guide explains the most common pip and package installation problems in Termux, what causes them and how to troubleshoot them safely.
One important difference from many desktop Linux distributions is that Termux uses a rolling-release model: its packages are expected to be upgraded together, and partial upgrades are not supported.
Table of Contents
- Before Troubleshooting
- Understand pkg and apt
- Update Termux Correctly
- Fix Repository and Mirror Errors
- Install Python Correctly
- Install pip Correctly
- Fix pip Install Errors
- Externally Managed Environment
- Fix Wheel and Build Errors
- Missing Compiler Errors
- ModuleNotFoundError
- Python Version Compatibility
- Permission Errors
- SSL and Certificate Errors
- Network and DNS Errors
- Broken Packages and Dependencies
- Clear pip Cache
- Use Python Virtual Environments
- Useful Diagnostic Commands
- Common Mistakes
- Recommended Repair Workflow
- Frequently Asked Questions
1. Before Troubleshooting
Before changing anything, identify exactly which command failed and read the last several lines of the error message.
Run:
termux-infoThis can provide useful information about your Termux release, package manager, repositories and Android environment.
2. Understand pkg and apt
In a normal Termux installation, pkg is a convenience wrapper
around the underlying package manager. With the apt-based Termux environment,
commands ultimately interact with the Debian-style package system used by
Termux.
For normal package installation, beginners should generally use:
pkg install PACKAGE_NAMEFor example:
pkg install pythonYou can search for packages with:
pkg search PACKAGE_NAME3. Update Termux Correctly
Many package problems are caused by outdated packages or incomplete upgrades. Termux documentation states that packages use a rolling-release model and that partial upgrades are not supported.
Start with:
pkg update
pkg upgradeIf you want to perform the operations without interactive confirmation:
pkg update -y
pkg upgrade -y4. Fix Termux Repository and Mirror Errors
One of the most common reasons for pkg install failures is a
repository or mirror problem.
Termux's package-management documentation recommends using
termux-change-repo when a repository mirror needs to be changed.
Step 1 — Check your Termux information
termux-infoStep 2 — Change the repository mirror
termux-change-repoSelect an available mirror for the repositories you actually use.
Step 3 — Update again
pkg update
pkg upgradeTermux documentation specifically recommends changing mirrors when repository metadata errors occur and then upgrading packages after the mirror change.
Typical repository errors
E: The repository ... does no longer have a Release file
N: Metadata integrity can't be verified
E: Failed to fetch ...
Could not resolve hostThese messages usually indicate a repository, mirror, connectivity or DNS problem rather than a Python/pip problem.
5. Install Python Correctly
Python is packaged separately in Termux. Install it using the Termux package manager rather than downloading a random Python binary.
pkg install pythonThen verify it:
python --versionCheck where Python is located:
which python
Current Termux packaging has also moved pip into a separate
python-pip package. The current Python package metadata explicitly
notes that pip is separate from Python.
6. Install pip Correctly in Termux
If pip is missing, install the Termux-provided pip package:
pkg install python-pipThen verify:
pip --versionYou can also use:
python -m pip --version
The current Termux python-pip package is maintained separately
from Python and depends on the Termux Python package.
pip install --upgrade pip in Termux just because a generic Python
tutorial recommends it. Termux packages and its pip integration are managed
through the Termux package system. The Termux package source includes safeguards
around replacing the packaged pip installation.
7. Fix Basic pip Installation Errors
First make sure both Python and pip are available:
python --version
python -m pip --versionThen try installing your package:
python -m pip install PACKAGE_NAME
Using python -m pip is often preferable because it makes it clear
which Python interpreter is being used.
Example
python -m pip install requestsTest the installation:
python -c "import requests; print(requests.__version__)"8. Fix "Externally Managed Environment"
Modern Python environments may protect packages managed by the operating system or distribution package manager. Termux's Python environment is integrated with its own package system.
If pip displays an error mentioning an externally managed environment, do not immediately bypass the protection with a dangerous global installation command.
For application-specific Python dependencies, use a virtual environment when appropriate.
pkg install python
python -m venv myenv
source myenv/bin/activate
python -m pip install PACKAGE_NAMEWhen finished:
deactivate9. Fix "Could Not Build Wheels"
One of the most common pip errors is a message similar to:
ERROR: Could not build wheels for ...
Failed building wheel
Building wheel for ... failedThis usually means pip could not use an available pre-built wheel and tried to build the package locally from source.
On Android/Termux, native compilation can require additional development packages.
Install common build tools
pkg install clang make pkg-configDepending on the package, additional development libraries may be required.
For example, a package involving Rust-based extensions may require Rust:
pkg install rustA package requiring a particular external library may need the corresponding Termux development package.
10. Fix Missing Compiler Errors
Errors such as:
command 'clang' failed
No such file or directory: 'cc'
error: command not found
C compiler cannot create executablesoften indicate that a compiler or build tool is missing.
Try:
pkg install clang
pkg install make
pkg install pkg-configThen retry the package installation.
11. Fix ModuleNotFoundError
If Python displays:
ModuleNotFoundError: No module named 'requests'it generally means that the module is not installed in the Python environment currently being used.
Install it:
python -m pip install requestsThen test:
python -c "import requests; print('requests works')"Check which Python is running
which python
which pip
If python and pip point to different environments,
packages can appear to be installed while Python still cannot find them.
12. Python Version Compatibility Problems
Some Python packages do not immediately support every new Python version. This can lead to errors during installation or compilation.
Check your Python version:
python --versionIf the package documentation specifies a supported Python version, compare it with your installed version before troubleshooting further.
Do not randomly downgrade your system Python package. Instead, consider using a virtual environment or an application-specific Python version when your workflow requires it.
13. Fix Permission Errors
You may encounter errors such as:
Permission denied
Operation not permitted
Could not install packagesFirst determine whether you are trying to write into a system-managed directory or whether the problem is actually related to package ownership.
Avoid using sudo commands copied from Ubuntu tutorials. Standard
Termux installations do not use a traditional root-based Linux filesystem
layout.
For Python projects, a virtual environment can often avoid unnecessary permission conflicts:
python -m venv project-env
source project-env/bin/activate
python -m pip install PACKAGE_NAME14. Fix SSL and Certificate Errors
Errors such as:
SSL: CERTIFICATE_VERIFY_FAILED
CERTIFICATE_VERIFY_FAILED
Could not fetch URL
SSLErrorcan have several causes, including incorrect system time, certificate issues, outdated packages or network interception.
Check your date and time
Make sure Android's automatic date and time settings are correct.
Update Termux packages
pkg update
pkg upgradeTest HTTPS connectivity
curl -I https://pypi.orgIf HTTPS fails outside pip as well, the underlying problem may be network, certificate or DNS related rather than pip itself.
15. Fix Network and DNS Errors
Pip needs network connectivity to download packages unless the package is already available locally.
Test basic connectivity:
ping -c 4 pypi.orgTest HTTPS:
curl -I https://pypi.orgCheck DNS resolution:
nslookup pypi.orgIf DNS fails but your general network appears to work, investigate the Android network, VPN, private DNS or DNS configuration.
16. Fix Broken Packages and Dependencies
If Termux displays dependency or linker errors, first bring the complete environment up to date.
pkg update
pkg upgradeTermux specifically warns that partial upgrades can result in dynamic-library linker errors because packages and their dependencies can become incompatible. Its documentation recommends upgrading all packages to resolve these problems.
Example linker error
CANNOT LINK EXECUTABLE
library "libXXXX.so" not found
cannot locate symbol "XXXX"
Do not immediately download a random .so file from the Internet.
First update Termux packages and identify which package provides the required
library.
17. Clear pip Cache
Sometimes a corrupted or outdated cached package can cause installation problems.
You can inspect pip's cache:
python -m pip cache infoIf you have identified the cache as the problem, clear it:
python -m pip cache purgeThen retry the installation:
python -m pip install PACKAGE_NAME18. Use Python Virtual Environments
Virtual environments are one of the best ways to prevent Python dependency conflicts.
Create an environment
python -m venv myprojectActivate it
source myproject/bin/activateInstall packages
python -m pip install requestsCheck installed packages
python -m pip listLeave the environment
deactivateThis approach is especially useful when working on several Python projects that require different dependency versions.
19. Useful Diagnostic Commands
When troubleshooting, these commands can provide a useful snapshot of your environment.
# Termux information
termux-info
# Python version
python --version
# Pip version
python -m pip --version
# Python path
which python
# Pip path
which pip
# Installed Python packages
python -m pip list
# Package details
python -m pip show PACKAGE_NAME
# Search Termux packages
pkg search PACKAGE_NAME
# Check package installation
pkg list-installed
# Update package lists
pkg update
# Upgrade packages
pkg upgrade
# Check HTTPS connectivity
curl -I https://pypi.org20. Useful Error-to-Fix Table
| Error | Likely Cause | First Step |
|---|---|---|
| Unable to locate package | Repository/package issue | pkg update |
| Release file error | Repository mirror problem | termux-change-repo |
| pip: command not found | pip package missing | pkg install python-pip |
| ModuleNotFoundError | Python module unavailable | Install the required module in the correct environment |
| Could not build wheel | Source build/dependency problem | Read the build error and install required dependencies |
| clang not found | Compiler missing | pkg install clang |
| Permission denied | Environment/path issue | Use a virtual environment where appropriate |
| SSL error | Certificate/network/time issue | Check time, HTTPS and packages |
| CANNOT LINK EXECUTABLE | Package/library mismatch | pkg upgrade |
| Could not resolve host | DNS/network issue | Test DNS and HTTPS connectivity |
21. Common Termux Installation Mistakes
1. Using an outdated Termux build
Old Termux installations can cause package-management problems. Termux's package-management documentation notes that obsolete builds and old repositories can cause package command errors.
2. Mixing package managers from different Linux distributions
Commands from Ubuntu, Kali or Arch tutorials may not apply directly to Termux. Use Termux's package ecosystem and documentation.
3. Running partial upgrades
Termux uses a rolling release model and does not support partial upgrades. Keep the package environment synchronized.
4. Forcing pip to overwrite Termux packages
Avoid replacing Termux-managed Python components with arbitrary pip versions. The Termux packaging system specifically manages the pip installation and includes protections against replacing the packaged pip.
5. Installing everything globally
For project-specific Python libraries, virtual environments are usually a cleaner approach.
6. Ignoring the first meaningful error
A long pip traceback may contain dozens of lines. Focus on the first meaningful dependency, compiler, version or network error that explains the failure.
22. Recommended Termux Repair Workflow
If package and pip installation are both failing, work through the following sequence instead of trying random commands.
Step 1 — Check Termux
termux-infoStep 2 — Update repositories
pkg updateStep 3 — Upgrade all packages
pkg upgradeStep 4 — If repositories fail, change the mirror
termux-change-repoStep 5 — Verify Python
python --versionStep 6 — Install the Termux pip package
pkg install python-pipStep 7 — Verify pip
python -m pip --versionStep 8 — Test a simple package
python -m pip install requestsStep 9 — If a project requires isolated dependencies
python -m venv testenv
source testenv/bin/activate
python -m pip install requestsStep 10 — If installation still fails
Save the complete error output and investigate the specific failure instead of repeatedly reinstalling everything.
23. When You Should Reinstall Termux
Reinstallation should generally be a last resort, not the first troubleshooting step.
Before reinstalling, try:
- Checking
termux-info. - Changing the package mirror if necessary.
- Running a complete package upgrade.
- Checking Python and pip paths.
- Using a virtual environment.
- Reading the exact error message.
24. Advanced Tip: Don't Confuse pip Problems With Termux Problems
There are several layers involved in installing a Python package:
- Android networking
- Termux package repositories
- Python
- pip
- Python package metadata
- Pre-built wheels
- Native compilers
- System libraries
- Python version compatibility
A failure at one layer does not necessarily mean the entire Termux installation is broken.
For example, if pkg install python works but
pip install somepackage fails while compiling native code, the
problem may be the package's build requirements rather than Termux itself.
25. Frequently Asked Questions
Why does pip not work in Termux?
Common causes include missing python-pip, outdated packages,
repository problems, Python version compatibility, missing build dependencies,
network failures or package-specific issues.
How do I install pip in Termux?
pkg install python-pipThen verify it with:
python -m pip --versionCan I use sudo pip install in Termux?
Standard Termux installations do not require the traditional
sudo pip install workflow used in some desktop Linux tutorials.
Use Termux's package manager and Python virtual environments instead.
Why does Termux say "Unable to locate package"?
The package may not exist in your enabled repositories, your package lists may
be outdated, or your repository mirror may be unavailable. Start with
pkg update and check the repository configuration.
Why does pip say "Could not build wheels"?
Pip may be compiling the package from source because a compatible pre-built wheel is unavailable. The package may require compilers, development libraries, Rust or another build dependency.
How do I fix "ModuleNotFoundError"?
Install the missing package into the same Python environment that runs your program:
python -m pip install PACKAGE_NAMEShould I upgrade pip with pip?
Avoid blindly replacing Termux's packaged pip. Termux maintains pip through its
own python-pip package and its packaging system includes safeguards
around pip replacement.
Why does Python installation show a traceback but still work?
There have been reported Termux issues involving Python package post-install
tracebacks where Python and pip still function afterward. For example, a 2026
Termux issue reports a traceback involving py3compile while
installation nevertheless left python and pip
functional. If you encounter this situation, verify
python --version and pip --version before assuming the
installation completely failed.
Should I reinstall Termux if pip fails?
No. Reinstalling should normally be a last resort. First check repositories, package upgrades, Python/pip versions, virtual environments and the specific error message.
Conclusion
Most Termux package and pip problems can be diagnosed without completely reinstalling the application. The key is to determine whether the failure is caused by the Termux repository, package manager, Python installation, pip, network connection, dependency, compiler or the Python package itself.
The safest general strategy is:
termux-info
pkg update
pkg upgrade
python --version
python -m pip --versionThen troubleshoot the exact error rather than applying unrelated commands. For Python projects, virtual environments provide an additional layer of isolation and can prevent many dependency conflicts.
Responsible-use disclaimer: This article is intended for Termux administration, Python development, Linux learning and troubleshooting. Always review commands before executing them and maintain backups of important Termux data.
Author: Hacker World
