pip install în Python

Pachete și medii virtuale Python 3.4+ (pip inclus)

Instalează pachete Python de pe PyPI, cu o versiune anume sau la ultima versiune, împreună cu dependențele lor.

Sintaxă
python -m pip install pachet
python -m pip install "pachet==1.2.3"
python -m pip install -U pachet
python -m pip install -r requirements.txt

Ce face pip install

pip este instalatorul de pachete inclus în Python. pip install requests caută pachetul pe PyPI (pypi.org), îl descarcă împreună cu pachetele de care are nevoie și le instalează în Python-ul activ. Dacă pachetul este deja instalat, pip spune Requirement already satisfied și nu face nimic.

Poți cere o versiune exactă (requests==2.32.5), o limită ("requests>=2.32", cu ghilimele ca terminalul să nu interpreteze >) sau actualizarea la ultima versiune cu -U (--upgrade). -r requirements.txt instalează toate pachetele dintr-un fișier.

Forma python -m pip folosește sigur pip-ul Python-ului pe care îl rulezi, util când ai mai multe versiuni instalate. Lucrează într-un mediu virtual: pe multe sisteme Linux și pe macOS cu Homebrew, pip refuză să instaleze în Python-ul sistemului (eroarea externally-managed-environment).

Parametri

Parametru Descriere
pachet Numele pachetului, opțional cu versiune: pachet==1.0, "pachet>=1.0,<2", pachet[extra].
-U, --upgrade Actualizează pachetul la ultima versiune compatibilă.
-r fișier Instalează pachetele scrise în fișier, câte unul pe rând.
-e cale Instalează proiectul local în mod editabil: modificările din cod se văd fără reinstalare.
--user Instalează în folderul utilizatorului, nu în cel al sistemului (în afara mediilor virtuale).
-q Afișează mai puține mesaje.

Ce returnează

Mesaje despre ce s-a descărcat și instalat; ultima linie este Successfully installed ... sau o eroare.

Exemple

Exemplul 1: Instalarea unui pachet nou

pip descarcă requests și cele patru pachete de care depinde.

python -m pip install requests

Ieșire în terminal

Collecting requests
  Downloading requests-2.34.2-py3-none-any.whl.metadata (4.8 kB)
Collecting charset_normalizer<4,>=2 (from requests)
  Downloading charset_normalizer-3.5.2-cp314-cp314-macosx_10_13_universal2.whl.metadata (37 kB)
Collecting idna<4,>=2.5 (from requests)
  Downloading idna-3.20-py3-none-any.whl.metadata (8.1 kB)
Collecting urllib3<3,>=1.26 (from requests)
  Downloading urllib3-2.8.0-py3-none-any.whl.metadata (6.8 kB)
Collecting certifi>=2023.5.7 (from requests)
  Downloading certifi-2026.10.23-py3-none-any.whl.metadata (2.5 kB)
...
Installing collected packages: urllib3, idna, charset_normalizer, certifi, requests
Successfully installed certifi-2026.10.23 charset_normalizer-3.5.2 idna-3.20 requests-2.34.2 urllib3-2.8.0

Exemplul 2: Versiune exactă, apoi actualizare

Prima comandă instalează o versiune mai veche. -U o înlocuiește cu ultima versiune.

python -m pip install requests==2.32.5 -q
python -m pip install -U requests

Ieșire în terminal

Collecting requests
  Downloading requests-2.34.2-py3-none-any.whl.metadata (4.8 kB)
Requirement already satisfied: charset_normalizer<4,>=2 in ./.venv/lib/python3.14/site-packages (from requests) (3.5.2)
...
Installing collected packages: requests
  Attempting uninstall: requests
    Found existing installation: requests 2.32.5
    Uninstalling requests-2.32.5:
      Successfully uninstalled requests-2.32.5
Successfully installed requests-2.34.2

Exemplul 3: Pachet scris greșit

Dacă numele nu există pe PyPI, pip nu găsește nicio versiune. Verifică numele pe pypi.org.

python -m pip install reqeusts-xyz

Ieșire în terminal

ERROR: Could not find a version that satisfies the requirement reqeusts-xyz (from versions: none)
ERROR: No matching distribution found for reqeusts-xyz

Greșeli frecvente

  • Scrii pip install requests>=2.32 fără ghilimele. Terminalul vede > ca redirecționare și creează un fișier numit =2.32. Scrie "requests>=2.32".
  • Instalezi cu pip, dar rulezi programul cu alt Python, apoi primești ModuleNotFoundError. Folosește python -m pip cu același python cu care rulezi codul.
  • Folosești sudo pip install pe Linux. Poate strica pachetele sistemului. Lucrează într-un mediu virtual.
  • Confunzi numele pachetului cu numele modulului: instalezi beautifulsoup4, dar scrii import bs4; instalezi pillow, dar scrii import PIL.

Comenzi înrudite

  • python -m venv: Creează un mediu virtual: un folder cu propriul Python și propriile pachete, separat de restul sistemului.
  • pip uninstall: Dezinstalează unul sau mai multe pachete din Python-ul activ; dependențele lor rămân instalate.
  • pip list și pip show: Afișează pachetele instalate cu versiunile lor, pe cele care au versiuni noi și detaliile unui pachet.
  • requirements.txt: Fișierul text cu pachetele de care are nevoie un proiect, câte unul pe rând, instalat cu pip install -r.
  • uv add și uv remove: Adaugă sau elimină o dependență: actualizează pyproject.toml, uv.lock și mediul .venv dintr-o singură comandă.