Contents Menu Expand Light mode Dark mode Auto light/dark, in light mode Auto light/dark, in dark mode Skip to content
pip documentation v25.2.dev0
pip documentation v25.2.dev0
  • Getting Started
  • Installation
  • User Guide
  • Topic Guides
    • Authentication
    • Caching
    • Configuration
    • Dependency Resolution
    • More on Dependency Resolution
    • HTTPS Certificates
    • Local project installs
    • Repeatable Installs
    • Secure installs
    • VCS Support
    • Managing a different Python interpreter
    • Pip is not a workflow management tool
  • Reference
    • Build System Interface
      • pyproject.toml
      • setup.py (legacy)
    • Requirement Specifiers
    • Requirements File Format
    • Installation Report
    • pip inspect JSON output specification
  • Commands
    • pip
    • pip install
    • pip uninstall
    • pip inspect
    • pip list
    • pip show
    • pip freeze
    • pip check
    • pip lock
    • pip download
    • pip wheel
    • pip hash
    • pip search
    • pip index
    • pip cache
    • pip config
    • pip debug

Project

  • Development
    • Getting Started
    • Contributing
    • Continuous Integration
    • Issue Triage
    • Architecture of pip’s internals
      • Broad functionality overview
      • Repository anatomy & directory structure
      • Configuration File Handling
      • Finding and choosing files (index and PackageFinder)
      • Command Line Interface
      • Options that control the installation process
    • Release process
    • Vendoring Policy
  • UX Research & Design
    • How to Contribute
    • UX Guidance
    • UX Research Results
      • About pip’s Users
      • How Users Understand pip
      • How pip users think about security
      • How pip is used in interactive environments (i.e. CI, CD)
      • pip Personas
      • Prioritizing pip Features
      • Providing an override to install packages with conflicting dependencies
      • pip --force-reinstall
      • pip search
      • pip Upgrade Conflict
      • Improving pip’s Documentation
  • Changelog
  • Code of Conduct
  • GitHub
Back to top
View this page

pip search¶

Usage¶

python -m pip search [options] <query>
py -m pip search [options] <query>

Description¶

Attention

PyPI no longer supports pip search (or XML-RPC search). Please use https://pypi.org/search (via a browser) instead. See https://warehouse.pypa.io/api-reference/xml-rpc.html#deprecated-methods for more information.

However, XML-RPC search (and this command) may still be supported by indexes other than PyPI.

Search for PyPI packages whose name or summary contains <query>.

Options¶

-i, --index <url>¶

Base URL of Python Package Index (default https://pypi.org/pypi)

(environment variable: PIP_INDEX)

Examples¶

  1. Search for “peppercorn”

    $ python -m pip search peppercorn
    pepperedform    - Helpers for using peppercorn with formprocess.
    peppercorn      - A library for converting a token stream into [...]
    
    C:\> py -m pip search peppercorn
    pepperedform    - Helpers for using peppercorn with formprocess.
    peppercorn      - A library for converting a token stream into [...]
    
Next
pip index
Previous
pip hash
Copyright © The pip developers
Made with Sphinx and @pradyunsg's Furo
On this page
  • pip search
    • Usage
    • Description
    • Options
    • Examples