This is Gentoo's testing wiki. It is a non-operational environment and its textual content is outdated.

Please visit our production wiki at https://wiki.gentoo.org

pip

From Gentoo Wiki (test)
Jump to:navigation Jump to:search

Resources

Pip is Python's package management system. It references packages available in the official Python Package Index (PyPI).

Install

Emerge

root #emerge --ask dev-python/pip

Usage

In order for pip to operate correctly when installing new packages an active internet connection is a requirement.

Invocation

user $pip

Package installation

Warning
Running pip as root is not advised. It can render important system tools like emerge useless.[1]
Important
It is important to understand that packages installed using pip will not be tracked by Portage. This is the case for installing any package through means other than the emerge command. Possible conflicts can be created when installing a Python package that is available in the Portage tree, then installing the same package using pip.


Decide which package manager will work best for the use case: either use emerge or pip for Python packages, but not both. Some Python packages are not available in the Portage tree, in these cases the only option is to use pip. One possibility is to use the --user option to install Python packages in a user's home directory. This will avoid conflicts with Portage. Be wise and make good choices!

To install a package using the pip command, where package is the desired package:

user $pip install <package>

To install the package in a user's home directory, be signed-in as the desired user, then issue:

user $pip install --user <package>

This will install the package in the user's ~/.local/ directory.

Removal

To remove a package using pip:

user $pip uninstall <package>

See also

References