Skip to main content
Ctrl+K
conda 25.1.2.dev1 documentation - Home
  • Conda
  • Conda-build
  • Miniconda
  • conda.org
  • GitHub
  • Element
  • Discourse
  • Conda
  • Conda-build
  • Miniconda
  • conda.org
  • GitHub
  • Element
  • Discourse

Navigation

  • User guide
    • Getting started with conda
    • Installing conda
      • Installing on Windows
      • Installing on macOS
      • Installing on Linux
      • RPM and Debian Repositories for Miniconda
    • Tasks
      • Managing conda
      • Managing environments
      • Managing channels
      • Managing packages
      • Managing Python
      • Managing virtual packages
      • Creating custom channels
      • Creating projects
      • Viewing command-line help
    • Configuration
      • Using the .condarc conda configuration file
      • Settings
      • Administering a multi-user conda installation
      • Mirroring channels
      • Disabling SSL verification
      • Using non-standard certificates
      • Using Custom Locations for Environment and Package Cache
      • Improving interoperability with pip
      • Using the free channel
    • Concepts
      • Commands
      • Packages
      • Package specification
      • Package search and install specifications
      • Channels
      • Environments
      • Installing with conda
      • Performance
      • Conda for data scientists
      • Plugins
    • Troubleshooting
    • Cheatsheet
  • Configuration
  • Commands
    • conda clean
    • conda compare
    • conda config
    • conda create
    • conda doctor
    • conda env
      • conda env config
        • conda env config vars
          • conda env config vars list
          • conda env config vars set
          • conda env config vars unset
      • conda env create
      • conda env export
      • conda env list
      • conda env remove
      • conda env update
    • conda info
    • conda init
    • conda install
    • conda list
    • conda notices
    • conda package
    • conda remove
    • conda rename
    • conda run
    • conda search
    • conda update
  • Release notes
  • Glossary
  • Developer guide
    • Architecture
    • Contributing to conda
    • Development Environment
    • Deep dives
      • conda install
      • conda init and conda activate
      • conda config and context
      • Solvers
      • Logging
    • Writing Tests
      • Integration Tests
    • Deprecations
    • Releasing
    • Plugins
      • Auth Handlers
      • Health Checks
      • Request Headers
      • Post-commands
      • Pre-commands
      • Reporter Backends
      • Settings
      • Solvers
      • Subcommands
      • Virtual Packages
    • Specifications
      • Technical specification: solver state
    • API
      • conda
        • __main__
        • _vendor
          • frozendict
        • _version
        • activate
        • api
        • auxlib
          • collection
          • compat
          • decorators
          • entity
          • exceptions
          • ish
          • logz
          • type_coercion
        • base
          • constants
          • context
        • cli
          • actions
          • common
          • conda_argparse
          • find_commands
          • helpers
          • install
          • main
          • main_clean
          • main_commands
          • main_compare
          • main_config
          • main_create
          • main_env
          • main_env_config
          • main_env_create
          • main_env_export
          • main_env_list
          • main_env_remove
          • main_env_update
          • main_env_vars
          • main_export
          • main_info
          • main_init
          • main_install
          • main_list
          • main_mock_activate
          • main_mock_deactivate
          • main_notices
          • main_package
          • main_pip
          • main_remove
          • main_rename
          • main_run
          • main_search
          • main_update
          • python_api
        • common
          • _logic
          • _os
            • linux
            • osx
            • unix
            • windows
          • compat
          • configuration
          • constants
          • disk
          • io
          • iterators
          • logic
          • path
            • _cygpath
            • directories
            • python
            • windows
          • pkg_formats
            • python
          • serialize
          • signals
          • toposort
          • url
        • core
          • envs_manager
          • index
          • initialize
          • link
          • package_cache_data
          • path_actions
          • portability
          • prefix_data
          • solve
          • subdir_data
        • deprecations
        • env
          • env
          • installers
            • base
            • conda
            • pip
          • pip_util
          • specs
            • binstar
            • requirements
            • yaml_file
        • exception_handler
        • exceptions
        • exports
        • gateways
          • anaconda_client
          • connection
            • adapters
              • ftp
              • http
              • localfs
              • s3
            • download
            • session
          • disk
            • create
            • delete
            • link
            • lock
            • permissions
            • read
            • test
            • update
          • logging
          • repodata
            • jlap
              • core
              • fetch
              • interface
            • lock
          • subprocess
        • history
        • instructions
        • misc
        • models
          • channel
          • dist
          • enums
          • leased_path_entry
          • match_spec
          • package_info
          • prefix_graph
          • records
          • version
        • notices
          • cache
          • core
          • fetch
          • types
          • views
        • plan
        • plugins
          • hookspec
          • manager
          • post_solves
            • signature_verification
          • reporter_backends
            • console
            • json
          • solvers
          • subcommands
            • doctor
              • health_checks
          • types
          • virtual_packages
            • archspec
            • conda
            • cuda
            • freebsd
            • linux
            • osx
            • windows
        • reporters
        • resolve
        • testing
          • cases
          • fixtures
          • gateways
            • fixtures
          • helpers
          • integration
          • notices
            • fixtures
            • helpers
          • solver_helpers
        • trust
          • constants
          • signature_verification
        • utils
      • conda_env
        • cli
          • common
          • main
          • main_config
          • main_create
          • main_export
          • main_list
          • main_remove
          • main_update
          • main_vars
        • env
        • installers
          • base
          • conda
          • pip
        • pip_util
        • specs
          • binstar
          • requirements
          • yaml_file
  • Commands

conda search#

Search for packages and display associated information using the MatchSpec format.

MatchSpec is a query language for conda packages.

usage: conda search [-h] [--envs] [-i] [--subdir SUBDIR]
                    [--skip-flexible-search] [-c CHANNEL] [--use-local]
                    [--override-channels] [--repodata-fn REPODATA_FNS]
                    [--experimental {jlap,lock}] [--no-lock]
                    [--repodata-use-zst | --no-repodata-use-zst] [-C] [-k]
                    [--offline] [--json] [--console CONSOLE] [-v] [-q]

Named Arguments#

--envs

Search all of the current user's environments. If run as Administrator (on Windows) or UID 0 (on unix), search all known environments on the system.

-i, --info

Provide detailed information about each package.

--subdir, --platform

Search the given subdir. Should be formatted like 'osx-64', 'linux-32', 'win-64', and so on. The default is to search the current platform.

--skip-flexible-search

Do not perform flexible search if initial search fails.

Channel Customization#

-c, --channel

Additional channel to search for packages. These are URLs searched in the order they are given (including local directories using the 'file://' syntax or simply a path like '/home/conda/mychan' or '../mychan'). Then, the defaults or channels from .condarc are searched (unless --override-channels is given). You can use 'defaults' to get the default packages for conda. You can also use any name and the .condarc channel_alias value will be prepended. The default channel_alias is https://conda.anaconda.org/.

--use-local

Use locally built packages. Identical to '-c local'.

--override-channels

Do not search default or .condarc channels. Requires --channel.

--repodata-fn

Specify file name of repodata on the remote server where your channels are configured or within local backups. Conda will try whatever you specify, but will ultimately fall back to repodata.json if your specs are not satisfiable with what you specify here. This is used to employ repodata that is smaller and reduced in time scope. You may pass this flag more than once. Leftmost entries are tried first, and the fallback to repodata.json is added for you automatically. For more information, see conda config --describe repodata_fns.

--experimental

Possible choices: jlap, lock

jlap: Download incremental package index data from repodata.jlap; implies 'lock'. lock: use locking when reading, updating index (repodata.json) cache. Now enabled.

--no-lock

Disable locking when reading, updating index (repodata.json) cache.

--repodata-use-zst, --no-repodata-use-zst

Check for/do not check for repodata.json.zst. Enabled by default. (default: Null)

Networking Options#

-C, --use-index-cache

Use cache of channel index files, even if it has expired. This is useful if you don't want conda to check whether a new version of the repodata file exists, which will save bandwidth.

-k, --insecure

Allow conda to perform "insecure" SSL connections and transfers. Equivalent to setting 'ssl_verify' to 'false'.

--offline

Offline mode. Don't connect to the Internet.

Output, Prompt, and Flow Control Options#

--json

Report all output as json. Suitable for using conda programmatically.

--console

Select the backend to use for normal output rendering.

-v, --verbose

Can be used multiple times. Once for detailed output, twice for INFO logging, thrice for DEBUG logging, four times for TRACE logging.

-q, --quiet

Do not display progress bar.

Examples:

Search for a specific package named 'scikit-learn':

conda search scikit-learn

Search for packages containing 'scikit' in the package name:

conda search *scikit*

Note that your shell may expand '*' before handing the command over to conda. Therefore, it is sometimes necessary to use single or double quotes around the query:

conda search '*scikit'
conda search "*scikit*"

Search for packages for 64-bit Linux (by default, packages for your current platform are shown):

conda search numpy[subdir=linux-64]

Search for a specific version of a package:

conda search 'numpy>=1.12'

Search for a package on a specific channel:

conda search conda-forge::numpy
conda search 'numpy[channel=conda-forge, subdir=osx-64]'

On this page
  • Named Arguments
  • Channel Customization
  • Networking Options
  • Output, Prompt, and Flow Control Options
Edit on GitHub
Show Source

© Copyright 2017, Anaconda, Inc.

Created using Sphinx 7.4.7.

Analytics Dashboard

Built with the PyData Sphinx Theme 0.15.4.