pixi remove

Removes dependencies from the workspace

If the project manifest is a pyproject.toml, removing a pypi dependency with the --pypi flag will remove it from either

• the native pyproject project.dependencies array or the native project.optional-dependencies table (if a feature is specified)
• pixi pypi-dependencies tables of the default or a named feature (if a feature is specified)

Usage

pixi remove [OPTIONS] <SPEC>...

Arguments

• <SPEC>

  The dependency as names, conda MatchSpecs or PyPi requirements
  May be provided more than once.
  required: true

Options

• --pypi

  The specified dependencies are pypi dependencies. Conflicts with host and build

• --platform (-p) <PLATFORM>

  The platform for which the dependency should be modified. Must be the name of a platform already defined in the workspace
  May be provided more than once.

• --feature (-f) <FEATURE>

  The feature for which the dependency should be modified
  default: default

• --environment (-e) <ENVIRONMENT>

  The environment for which the dependency should be modified. The dependency is written to the content defined inline on the environment, creating the environment if it does not exist

Config Options

• --no-config

  Don't read system or user-level configuration files. Project-local <project>/.pixi/config.toml is still loaded
  env: PIXI_NO_CONFIG
  default: false

• --config-file <PATH>

  Load configuration from this file instead of searching system and user-level paths. Project-local <project>/.pixi/config.toml is still merged on top
  env: PIXI_CONFIG_FILE

• --auth-file <AUTH_FILE>

  Path to the file containing the authentication token

• --concurrent-downloads <CONCURRENT_DOWNLOADS>

  Max concurrent network requests, default is 50

• --concurrent-solves <CONCURRENT_SOLVES>

  Max concurrent solves, default is the number of CPUs

• --pinning-strategy <PINNING_STRATEGY>

  Set pinning strategy
  options: semver, minor, major, latest-up, exact-version, no-pin

• --pypi-keyring-provider <PYPI_KEYRING_PROVIDER>

  Specifies whether to use the keyring to look up credentials for PyPI
  options: disabled, subprocess

• --run-post-link-scripts

  Run post-link scripts (insecure)

• --no-symbolic-links

  Disallow symbolic links during package installation
  env: PIXI_NO_SYMBOLIC_LINKS

• --no-hard-links

  Disallow hard links during package installation
  env: PIXI_NO_HARD_LINKS

• --no-ref-links

  Disallow ref links (copy-on-write) during package installation
  env: PIXI_NO_REF_LINKS

• --tls-no-verify

  Do not verify the TLS certificate of the server

• --offline=<OFFLINE>

  Run without network access, using only cached data. Commands fail if data is missing from the cache. Pass --offline=false to override an offline setting from the configuration
  env: PIXI_OFFLINE
  options: y, yes, t, true, on, 1, n, no, f, false, off, 0

• --tls-root-certs <TLS_ROOT_CERTS>

  Which TLS root certificates to use: 'webpki' (bundled Mozilla roots) or 'system' (system store)
  env: PIXI_TLS_ROOT_CERTS

• --use-environment-activation-cache

  Use environment activation cache (experimental)

Git Options

• --git (-g) <GIT>

  The git url to use when adding a git dependency

• --branch <BRANCH>

  The git branch

• --tag <TAG>

  The git tag

• --rev <REV>

  The git revision

• --subdirectory (-s) <SUBDIRECTORY>

  The subdirectory of the git repository to use

Update Options

• --no-install

  Don't modify the environment, only modify the lock file
  env: PIXI_NO_INSTALL

• --frozen

  Install the environment as defined in the lock file, doesn't update lock file if it isn't up-to-date with the manifest file
  env: PIXI_FROZEN

• --locked

  Check if lock file is up-to-date before installing the environment, aborts when lock file isn't up-to-date with the manifest file
  env: PIXI_LOCKED

Global Options

• --manifest-path (-m) <MANIFEST_PATH>

  The path to pixi.toml, pyproject.toml, or the workspace directory

• --workspace (-w) <WORKSPACE>

  Name of the workspace

Description

Removes dependencies from the workspace.

If the workspace manifest is a pyproject.toml, removing a pypi dependency with the --pypi flag will remove it from either

• the native pyproject project.dependencies array or, if a feature is specified, the native project.optional-dependencies table

• pixi pypi-dependencies tables of the default feature or, if a feature is specified, a named feature

Examples

pixi remove numpy
pixi remove numpy pandas pytorch
pixi remove --manifest-path ~/myworkspace/pixi.toml numpy
pixi remove --host python
pixi remove --build cmake
pixi remove --pypi requests
pixi remove --platform osx-64 --build clang
pixi remove --feature featurex clang
pixi remove --environment dev clang
pixi remove --feature featurex --platform osx-64 clang
pixi remove --feature featurex --platform osx-64 --build clang
pixi remove --no-install numpy