Home Original page

Releases · conda/conda

26.1.1

Bug fixes

  • Fix conda doctor --fix failing with install() missing 1 required positional argument: 'parser' when attempting to fix packages with missing files. (#15669)

Contributors

Full Changelog: 26.1.0...26.1.1

26.1.0

Enhancements

  • Allow custom_multichannels.defaults to override default_channels. Continuation of effort to devendor conda and remove hardcoded "defaults" channel. (#14661)
  • Defer PrefixData record instantiation until they are accessed for faster query performance. (#14811)
  • Add support for Python 3.14. (#15080, #15618)
  • Speed up the context initialization process by caching condarc file reads. (#15150)
  • Raise a NoChannelsConfiguredError when attempting to solve an environment with no channels configured, and provide a helpful message to guide users in adding channels. (#15262 via #15345)
  • Add conda.cli.condarc.ConfigurationFile class to expose configuration file manipulation interface programmatically. This allows other Python interfaces to read and modify conda configuration files without shelling out to conda config commands. (#15238 via #15376)
  • Add -s as a shorthand alias for conda run --no-capture-output. (#15426)
  • conda run now deactivates the environment on exiting the command. (#15427)
  • Rename conda.models.enums.PathType enum to conda.models.enums.PathEnum to resolve a naming conflict with the PathType type annotation. This change follows modern Python conventions and establishes the *Enum suffix as the pattern for enums in the codebase. (#15428)
  • Validate plugin-provided HTTP headers and raise PluginError if forbidden headers are detected, preventing plugins from compromising conda's network stack. (#15405 via #15436)
  • Add conda_package_extractors plugin hook to allow plugins to register custom package archive extractors. (#15524 via #15441)
  • Add -O as a flag alias for --override-channels. (#15499)
  • Add reusable http_test_server fixture to conda.testing module for serving mock conda channels and remote files in tests. Fixture uses standard @pytest.mark.parametrize() with indirect=True for configuring directories, supporting both pre-existing directories and dynamic content generation. Provides clean API with get_url() helper method and directory attribute. (#15528 via #15529)
  • Speed up conda run by inlining environment activation instead of using a subprocess. (#15534)
  • Add a --size flag to the conda info --envs and conda env list commands to display disk usage for each environment. (#8040 and #15544)
  • Add PrefixRecord.package_size() and PrefixData.size for programmatic access to conda-managed disk usage. (#15544)
  • Add --size flag to conda list to show environment size and package sizes. (#15544)
  • Improve error messages for HTTP 403 (Forbidden) responses with context-aware guidance on authentication and permissions. (#15594)
  • Improve error message when conda activate fails on Windows due to unwritable %TEMP% directory. (#15601 via #15602)
  • Package extension detection is now dynamic based on registered conda_package_extractors plugins. (#15629)
  • Allow conda create --download-only to run without specifying -n/--name or -p/--prefix, similar to --dry-run. (#15633)
  • Add --fix flag to conda doctor with health check fix capabilities. (#15530)
  • Improve error message when conda env export is invoked with an invalid platform. (#15561)

Bug fixes

  • Stop conda run from adding an additional new line after printing to stdout or stderr. (#11763 via #15539)
  • Non-conda installed Python packages now show up in conda list in free-threading environments. (#14674)
  • Fix Python packages not being listed as from the pypi channel if the site-packages directory includes a symlink. (#14674)
  • Replace deprecated codecs.open() with built-in open() for Python 3.14 compatibility. (#15080)
  • Fix parallel conda command failures on Windows (e.g., start /b) by using GUIDs for unique temp filenames instead of %RANDOM%. (#15169 via #15598)
  • Sanitize channel config input to remove null values. (#15268 via #15323)
  • Fix conda list --fields dist_str representation. (#15420)
  • Add the -- separator such that conda run can properly separate executable options from conda options when invoking commands. Now, executable options are correctly parsed and handled. (#15432)
  • Raise an error when no command is provided to conda run, instead of proceeding with an empty command. (#15437)
  • Do not expose __cuda virtual package when no CUDA version was detected. (#15500)
  • Ensure an appropriate error code is returned when conda run is invoked with an invalid environment name or prefix. (#15534)
  • Record size_in_bytes for generated entry points and compiled .pyc files in the prefix manifests. (#15544)
  • Allow conda env update to execute an update on an environment for environment files that do not have conda dependencies. (#15569 via #15570)
  • Terminate activation early on Windows when activation scripts fail. (#15616)
  • Fix package installation from repodata v3 channels by extracting the correct filename from the URL instead of using the repodata key. This resolves issues when installing packages where the repodata key differs from the actual filename (e.g., wheel packages where the key uses underscores but the filename uses hyphens). (#15620 via #15626)
  • Fix incorrect source location in deprecation warnings when multiple constants are deprecated in the same module. (#15623 via #15624)
  • Fix conda clean --tarballs not cleaning up .partial download files. (#15634 via #15635)
  • Decode SHA256 fields in Python's RECORD metadata files. (#15591)
  • Fix CondaJSONEncoder to support serializing frozendicts. (#15532)
  • Fix argument parser aliases incorrectly defined as a string instead of a tuple. (#15418)
  • Raise an error when attempting to deactivate an environment that is not currently active. (#15609)

Deprecations

  • Mark conda.exception_handler.ExceptionHandler._upload as pending deprecation, to be removed in 27.3. (#13900 via #14698)
  • Mark conda.exception_handler.ExceptionHandler._ask_upload as pending deprecation, to be removed in 27.3. (#13900 via #14698)
  • Mark conda.exception_handler.ExceptionHandler._execute_upload as pending deprecation, to be removed in 27.3. (#13900 via #14698)
  • Mark conda.exception_handler.ExceptionHandler._post_upload as pending deprecation, to be removed in 27.3. (#13900 via #14698)
  • Mark private helper functions in conda.cli.main_config (_key_exists, _get_key, _set_key, _remove_item, _remove_key, _read_rc, _write_rc, _validate_provided_parameters) as pending deprecation, to be removed in 27.3. Use the new ConfigurationFile class instead. (#15376)
  • Mark conda.models.enums.PathType as pending deprecation, to be removed in 27.3. Use conda.models.enums.PathEnum instead. (#15428)
  • Mark conda.utils.massage_arguments as pending deprecation, to be removed in 27.3. (#15439)
  • Mark conda.gateways.disk.create.extract_tarball as pending deprecation, to be removed in 27.3. Use conda.base.context.context.plugin_manager.extract_package instead. (#15524 via #15441)
  • Mark the use_system_tmp_path argument of conda.utils.wrap_subprocess_call(use_system_tmp_path=...) as pending deprecation, to be removed in 27.3. Use the TMPDIR, TEMP, or TMP environment variables to set the system temporary directory location. (#15440 via #15442)
  • Mark private helper functions in conda.common.serializers (_yaml_round_trip, _yaml_safe) as pending deprecation, to be removed in 27.3. Use conda.common.serialize.yaml._yaml() instead. (#15503)
  • Mark conda.common.serializers.yaml_round_trip_load and conda.common.serializers.yaml_safe_load as pending deprecation, to be removed in 27.3. Use conda.common.serialize.yaml.load() instead. (#15503)
  • Mark conda.common.serializers.yaml_round_trip_dump and conda.common.serializers.yaml_safe_dump as pending deprecation, to be removed in 27.3. Use conda.common.serialize.yaml.dump() instead. (#15503)
  • Mark conda.cli.actions.NullCountAction._ensure_value as pending deprecation, to be removed in 27.3. (#15512)
  • Mark conda.exports.input as pending deprecation, to be removed in 27.3. Use builtins.input instead. (#15523 via #15526)
  • Mark conda.exports.StringIO as pending deprecation, to be removed in 27.3. Use io.StringIO instead. (#15523 via #15526)
  • Mark conda.exports.PY3 as pending deprecation, to be removed in 27.3. Python 2 is no longer supported. (#15523 via #15526)
  • Mark conda.exports.string_types as pending deprecation, to be removed in 27.3. Use str instead. (#15523 via #15526)
  • Mark conda.exports.text_type as pending deprecation, to be removed in 27.3. Use str instead. (#15523 via #15526)
  • Mark conda.exports.DEFAULT_CHANNELS as pending deprecation, to be removed in 27.3. Use conda.base.constants.DEFAULT_CHANNELS instead. (#15523 via #15526)
  • Mark conda.exports.DEFAULT_CHANNELS_UNIX as pending deprecation, to be removed in 27.3. Use conda.base.constants.DEFAULT_CHANNELS_UNIX instead. (#15523 via #15526)
  • Mark conda.exports.DEFAULT_CHANNELS_WIN as pending deprecation, to be removed in 27.3. Use conda.base.constants.DEFAULT_CHANNELS_WIN instead. (#15523 via #15526)
  • Mark conda.exports.PREFIX_PLACEHOLDER as pending deprecation, to be removed in 27.3. Use conda.base.constants.PREFIX_PLACEHOLDER instead. (#15523 via #15526)
  • Mark conda.exports._PREFIX_PLACEHOLDER as pending deprecation, to be removed in 27.3. Use conda.base.constants.PREFIX_PLACEHOLDER instead. (#15523 via #15526)
  • Mark conda.exports.prefix_placeholder as pending deprecation, to be removed in 27.3. Use conda.base.constants.PREFIX_PLACEHOLDER instead. (#15523 via #15526)
  • Mark conda.exports.CondaError as pending deprecation, to be removed in 27.3. Use conda.CondaError instead. (#15523 via #15526)
  • Mark conda.exports.CondaHTTPError as pending deprecation, to be removed in 27.3. Use conda.exceptions.CondaHTTPError instead. (#15523 via #15526)
  • Mark conda.exports.CondaOSError as pending depr...

Read more

25.11.1

25.11.0

Enhancements

  • Add three new fields to conda.plugins.types.CondaVirtualPackage class:
    • override_entity: Control which field (version or build number) can be overridden
    • empty_override: Specify behavior when override value is empty
    • version_validation: Validate override version values
      These fields abstract and generalize the version/build number override logic into the CondaVirtualPackages class, removing the need for individual virtual packages to implement their own override handling. (#15248)
  • Add a new override_virtual_packages (with alias virtual_packages) key to condarc. (#15156 via #15318)
  • Add .created and .last_modified properties to PrefixData, which provide information about the creation and last modification times of a given environment, respectively. (#14308 via #15329)
  • Add a new envs_details field to the conda info --json output to inspect properties of the registered environments. This is also part of the conda info --envs --json and conda env list --json outputs. (#15330)
  • conda.plugins.reporter_backends.JSONReporterRenderer.envs_list now allows dict[str, dict[str, str | bool]], which is passed directly to the JSON dumper. (#15330)

Bug fixes

  • Ensure MatchSpec serialization does not contain orphan = separator when the version field is set to *. (#14357 via #15294)
  • Require conda-libmamba-solver >=25.4.0. (#15289)
  • Fix Channel.urls() to respect explicit subdirs parameter when the channel has a platform defined. (#14258)
  • Include platform in Channel equality and hash checks. (#14259 via #15296)
  • Fix where conda search --json --use-index-cache <package> could fail to encode message as json, when cache is empty. (#15308)
  • Adjust whitespace in conda info --envs header. (#15330)
  • Fix plugin settings YAML serialization to use valid nested YAML format for plugin settings in conda config --describe output. (#15339 via #15341)
  • Fix several bugs related to Python 3.14 compatibility. (#15079, #15088 via #15340)
  • Ignore and warn user if the PATH environment variable is set in the environment config. Conda should not enable modifying the PATH to any arbitrary value. (#15342)
  • Restrict the JSON output to only the envs list when conda info --envs --json and conda env list --json are called. (#15353)
  • Produce a warning when a user tries to add a PATH environment variable to their environment configuration. Adding reserved env vars like PATH to the environment variables config for an environment may produce unexpected results in conda. (#15292 via #15354)
  • Fix zsh parse error on Windows. (#13915, #9922 via #15335)
  • Remove return from try-finally per PEP-765. (#15370 via #15371)

Deprecations

  • Mark conda.plugins.hookspec.spec_name as pending deprecation, to be removed in 26.9. Use conda.base.constants.APP_NAME instead. (#15255)
  • Mark conda.cli.main_compare.get_packages as pending deprecation, to be removed in 26.9. Use conda.core.prefix_data.PrefixData.map_records instead. (#15387)

Docs

  • Expand contributor documentation. (#15208)
  • Reference conda.plugins.types.* instead of re-exports from conda.plugins. (#15307)
  • Use --name more consistently in getting started docs. (#15346)

Other

  • Reduce warnings in tests. (#15307)
  • Performance improvements for the conda env list command, which now defers retrieving environment information until necessary. (#15320)
  • Stop using assertions in non-testing code, and enable the corresponding linting rules. (#15357 via #15361)

Contributors

25.9.1

25.9.0

✨ Special Announcement ✨

Following feedback from conda users last year about the pre-configuration of the conda code base to favor channels from Anaconda Inc, we've finished removing hardcoding Anaconda's channels as the default set of channels in the conda source code.

It is now up to providers of the conda distributions, such as miniforge or Anaconda (including miniconda), to pre-configure their preferred channels, e.g. by running the necessary conda config --set channels command.

Enhancements

  • Add conda doctor check for if the pinned file is ill-formatted. (#7978 via #15022)
  • If an HTTP error response includes a field named detail, relay that as the error message. Stop uppercasing the error message. (#15021 via #15037)
  • Raise exceptions to prevent renaming or removing the environment specified by default_activation_env. (#15061)
  • Make conda list REGEX raise an exception with exit code 1 when the regular expression does not match any packages in the target environment. (#15074 via #15075)
  • Add a bytes cache to support sharded repodata. (#15083)
  • Add a "file locking" health check to conda doctor. (#13921 & #14948 via #15114)
  • Add a new environment spec plugin, called cep-24, that implements the environment.yml specification in CEP 24. This is enabled by default. (#15120)
  • Change the environment.yml plugin to be disabled by default. Users can explicitly use it by setting the --environment-specifier flag. (#15120)
  • Add conda.models.environment.Environment.extrapolate to extrapolate the environment for a different platform. (#15157 via #15183)
  • Add CondaEnvironmentExporter.multiplatform_export to support export formats with multiple platforms. (#15159 via #15253, #15261)
  • Update dev/start/dev\start.bat scripts to allow choosing between miniconda and miniforge installers via -i/--installer flag, installer_type in ~/.condarc configuration, or interactive prompt when not specified. (#15084 via #15163)
  • Report environments marked as frozen (CEP 22) with + in conda info --envs and conda env list. (#15213)

Bug fixes

  • Slash-normalize PrefixRecord.files entries on Windows to emit correct output for conda list in environments created by (micro)mamba. (#14523)
  • Silence error in fish when undefined environment variables are unset. (#14659 via #14660, #15102)
  • Fix validate_subdir_config cli validation -- only search config file context sources for subdir configuration. (#15020 via #15038)
  • Fix conda install/create/update commands to not ignore CLI arguments if an explicit package is specified to install. (#15028)
  • Override create_default_packages setting for specs originating from files. (#15041)
  • Don't install explicit packages if invoked with conda update. (#15044)
  • Update conda create --clone to disallow users to specify a --file CLI argument. (#15702 via #15073)
  • Ignore explicit packages specified in create_default_packages setting and provide a helpful warning message for the setting. (#15115)
  • Avoid triple-equals string exports when the MatchSpec.version field starts with a single equals. (#15123 via #15141)
  • Respect CONDA_PROTECT_FROZEN_ENVS environment variable in the absence of --override-frozen. (#15162)
  • Indicate that a dry run was performed and no changes were made when running conda init --dry-run. (#15097 via #15211)
  • Don't load the environment.yml environment as part of its can_handle function. Just verify if the plugin will be able to interpret the provided file. For the environment.yml plugin, it can read any .yml/.yaml file. (#15237)

Deprecations

  • Mark conda.cli.common.specs_from_url keyword argument json as pending deprecation, to be removed in 26.9. (#15028)
  • Mark re-exports from conda.plugins.types in conda.plugins as pending deprecation, to be removed in 26.9. Import from conda.plugins.types instead:
    • conda.plugins.CondaAuthHandler → conda.plugins.types.CondaAuthHandler
    • conda.plugins.CondaEnvironmentSpecifier → conda.plugins.types.CondaEnvironmentSpecifier
    • conda.plugins.CondaHealthCheck → conda.plugins.types.CondaHealthCheck
    • conda.plugins.CondaPostCommand → conda.plugins.types.CondaPostCommand
    • conda.plugins.CondaPostSolve → conda.plugins.types.CondaPostSolve
    • conda.plugins.CondaPostTransactionAction → conda.plugins.types.CondaPostTransactionAction
    • conda.plugins.CondaPreCommand → conda.plugins.types.CondaPreCommand
    • conda.plugins.CondaPrefixDataLoader → conda.plugins.types.CondaPrefixDataLoader
    • conda.plugins.CondaPreSolve → conda.plugins.types.CondaPreSolve
    • conda.plugins.CondaPreTransactionAction → conda.plugins.types.CondaPreTransactionAction
    • conda.plugins.CondaReporterBackend → conda.plugins.types.CondaReporterBackend
    • conda.plugins.CondaRequestHeader → conda.plugins.types.CondaRequestHeader
    • conda.plugins.CondaSetting → conda.plugins.types.CondaSetting
    • conda.plugins.CondaSolver → conda.plugins.types.CondaSolver
    • conda.plugins.CondaSubcommand → conda.plugins.types.CondaSubcommand
    • conda.plugins.CondaVirtualPackage → conda.plugins.types.CondaVirtualPackage
  • Add deprecation warnings for invalid fields in environment.yml files. (#15120)
  • Mark conda.core.index.calculate_channel_urls as pending deprecation, to be removed in 26.9. Use conda.models.channel.all_channel_urls(conda.base.context.context.channels) instead. (#15173)
  • Stop implicitly adding the defaults channel to the channel list. (#15196)
  • Mark conda.core.index._supplement_index_with_system as pending deprecation, to be removed in 26.3.
  • Postpone conda.utils.unix_path_to_win deprecation to 26.3. Use conda.common.path.unix_path_to_win instead. (#15230)
  • Constrain minimum compatible conda-build version as >= 25.9 (#15235)
  • Mark conda.auxlib.compat.isiterable as pending deprecation, to be removed in 26.9. Use conda.common.compat.isiterable instead. (#15252)
  • Remove conda.activate._Activator.commands. Use conda commands instead. (#15179)
  • Remove conda.activate._Activator._parse_and_set_arts argument arguments. (#15179)
  • Remove conda.activate.ensure_binary. Use conda.common.compat.ensure_binary instead. (#15179)
  • Remove conda.activate.ensure_fs_path_encoding. (#15179)
  • Remove constants conda.activate._cygpath, conda.activate.native_path_to_unix, conda.activate.unix_path_to_native, conda.activate.path_identity. (#15179)
  • Remove conda.cli.common.confirm. Use conda.reporters.confirm_yn instead. (#15180)
  • Remove conda.cli.common.confirm_yn. Use conda.reporters.confirm_yn instead. (#15180)
  • Remove conda.cli.common.print_envs_list. Use conda.reporters.render(style='env_list') instead. (#15180)
  • Remove conda env create remote_definition argument. (#15181)
  • Remove conda env update remote_definition argument. (#15181)
  • Remove conda.env.specs.binstar.BinstarSpec class. (#15181)
  • Remove experimental Binstar environment spec plugin. (#15181)
  • Remove conda.cli.main_env_remove.execute.Use conda.cli.main_remove.execute instead. (#15182)
  • Remove conda.cli.install.validate_new_prefix. Use conda.cli.install.validate_new_prefix instead. (#15182)
  • Remove constant conda.exports.win_path_to_unix. (#15184)
  • Remove constant conda.exports.unix_path_to_win. (#15184)
  • Remove conda.exports.iteritems. Use builtin dict.items() instead. (#15184)
  • Remove unused class conda.exports.Completer. (#15184)
  • Remove unused class conda.exports.InstalledPackages. (#15184)
  • Remove constant conda.exports.move_to_trash. (#15184)
  • Remove constant conda.exports.KEYS. (#15184)
  • Remove constant conda.exports.KEYS_DIR. (#15184)
  • Remove unused method conda.exports.verify. (#15184)
  • Remove conda.exports.symlink_conda. Use conda.activate instead. (#15184)
  • Remove conda.exports._symlink_conda_help. Use conda.activate instead. (#15184)
  • Remove conda.exports.win_conda_bat_redirect. Use conda.activate instead. (#15184)
  • Remove constants conda.testing.CondaCLIFixture, conda.testing.conda_cli, conda.testing.PathFactoryFixture, conda.testing.path_factory, conda.testing.TmpEnvFixture, conda.testing.tmp_env, conda.testing.TmpChannelFixture, conda.testing.tmp_channel, conda.testing.context_aware_monkeypatch, conda.testing.tmp_pkgs_dir, conda.testing.tmp_envs_dir. (#15185)
  • Remove constant conda.testing.integration.BIN_DIRECTORY. (#15185)
  • Remove conda.misc.rel_path. (#15190)
  • Remove argument index_args conda.misc.explicit. (#15190)
  • Remove constant conda.utils.path_identity. Use conda.common.path.path_identity instead. (#15191)
  • Remove conda.utils.win_path_to_cygwin. Use conda.common.path.win_path_to_cygwin instead. (#15191)
  • Remove conda.utils.translate_stream. (#15191)
  • Remove constant conda.utils._UNIX_SHELL_BASE. Use conda.activate instead. (#15191)
  • Remove constant conda.utils._MSYS2_SHELL_BASE. Use conda.activate instead. (#15191)
  • Remove constant conda.utils._SHELLS. Use conda.activate instead. (#15191)
  • Remove free channel from channel configuration. (#15195)
  • Remove deprecated property conda.base.context.restore_free_channel. (#15195)
  • Remove field conda.base.context._restore_free_channel. (#15195)
  • Remove deprecation warning conda.base.context._warn_defaults_deprecation. (#15196)
  • Remove deprecated module conda.cli.python_api. (#15219)
  • Remove deprecated module conda.common.disk. (#15219)
  • Remove deprecated constant FILESYSTEM_ENCODING from conda.common.compat. (#15220)
  • Remove deprecated function open from conda.common.compat. Use conda.common.compat.open_utf8 instead. (#15220)
  • Remove deprecated function six_with_metaclass...

Read more

25.7.0

25.7.0 (2025-08-01)

Enhancements

  • Ensure conda does not allow for mixing input file types. (#14684 via #14725)
  • Add "environment consistency" health check to conda doctor. (#14715 via #14799)
  • Add support for explicit environment specification files as a supported environment spec according to CEP-23, bringing parity between conda env and conda create/install/update. (#14820)
  • Add an experimental data model to represent an environment. (#14870)
  • Add config option environment_specifier and CLI argument (--environment-specifier, --env-spec) to allow users to select which environment specifier plugin to use. (#14877)
  • Enhance conda export command now supports plugin-based architecture with multiple output formats:
    • environment-yaml (cross-platform YAML, default format)
    • environment-json (cross-platform JSON for programmatic use)
    • explicit (CEP 23 compliant explicit URLs for exact reproduction)
    • requirements (MatchSpec-based requirements format) (#14886)
  • Add automatic export format detection based on filename patterns (e.g., environment.yaml, explicit.txt, requirements.txt) (#14886)
  • Add export format aliases for convenience (yaml, yml, json, reqs, txt) (#14886)
  • Introduce new dataclass conda.models.environment.EnvironmentConfig to represent Environment settings, a subset of context settings that impact environment creation and management. (#14913, #15026)
  • Allow env spec plugins to opt-out of auto detection. (#14914)
  • Handle exceptions coming from environment spec plugins can_handle functions. (#14916)
  • The conda package is included when cloning an environment. (#14917 via #14919)
  • Lazily evaluate CLI options originating from the plugin manager. (#14925)
  • Improve the error message that appears when duplicate records are found in the prefix. (#14927)
  • Add virtual packages field to the Environment model. (#14979)
  • Add ability to create EnvironmentConfig instances from a given context. (#14986)
  • Add CondaPlugin base class with name normalization. (#15002)
  • Enhance LazyChoicesAction with dynamic choices property and caching for improved CLI argument validation and help text generation. (#15046)

Bug fixes

  • Set default value for version parameter when build is set in MatchSpec.conda_build_form(). (#11200 via #15025)
  • Improve conda notices cache handling for better user experience. (#14229)
  • Improve type hints and error handling in conda installer functions. (#14820)
  • Fix conda export --override-channels behavior to properly include installed packages' channels (unless --ignore-channels is also provided), restoring the original intended functionality and improving environment reproducibility. (#15048 via #14886)
  • Fix tmp_channel fixture to also include dependencies in the temporary channel. (#14924)
  • Fix unsetting environment variables when envvars_force_uppercase = False. (#14934 via #14942)
  • Respect --platform option on subsequent environment operations after initial conda env create call. (#14949 via #14956)
  • Apply case normalization to all activation environment variables. (#14960)
  • Separate requirements.txt and explicit environment specs. (#14684 via #14963)
  • Fix EnvironmentConfig.aggressive_update_packages type. It is a list of strings, not a bool. (#14982)
  • Fix EnvironmentConfig.channel_settings type. It is a list of dicts, not a dict. (#14984)
  • Ensure file types can not be mixed in the conda install command. (#14999)
  • ProxyError now accepts an optional custom message parameter to provide more specific error details. (#14945)

Deprecations

  • Mark monkey-patching json to support frozendict and obj.to_json() as pending deprecation, to be removed in 26.9. Use conda.common.serialize.json.CondaJSONEncoder instead. (#14709)
  • Mark conda.auxlib.entity.EntityEncoder as pending deprecation, to be removed in 26.9. Use conda.common.serialize.json.CondaJSONEncoder instead. (#14709)
  • Mark conda.auxlib.logz.DumpEncoder as pending deprecation, to be removed in 26.9. Use conda.common.serialize.json.CondaJSONEncoder instead. (#14709)
  • Mark conda.auxlib.logz._DUMPS as pending deprecation, to be removed in 26.9. Use conda.common.serialize.json.CondaJSONEncoder(sort_keys=True).encode instead. (#14709)
  • Mark conda.auxlib.logz.jsondumps as pending deprecation, to be removed in 26.9. Use conda.common.serialize.json.CondaJSONEncoder(sort_keys=True).encode instead. (#14709)
  • Mark conda.common.serialize.EntityEncoder as pending deprecation, to be removed in 26.9. Use conda.common.serialize.json.CondaJSONEncoder instead. (#14709)
  • Mark conda.common.serialize.json_load as pending deprecation, to be removed in 26.9. Use conda.common.serialize.json.loads(sort_keys=True) instead. (#14709)
  • Mark conda.common.serialize.json_dump as pending deprecation, to be removed in 26.9. Use conda.common.serialize.json.dumps(sort_keys=True) instead. (#14709)
  • Mark conda.exports.EntityEncoder as pending deprecation, to be removed in 26.9. Use conda.common.serialize.json.CondaJSONEncoder instead. (#14709)
  • Mark conda.env.specs.binstar.BinstarSpec.environment as pending deprecation in 26.9. Use conda.env.specs.binstar.BinstarSpec.env instead. (#14397)
  • Mark conda.env.specs.requirements.RequirementsSpec.environment as pending deprecation in 26.9. Use conda.env.specs.requirements.RequirementsSpec.env instead. (#14397)
  • Mark conda.env.specs.yaml_file.YamlFileSpec.environment as pending deprecation in 26.9. Use conda.env.specs.yaml_file.YamlFileSpec.env instead. (#14397)
  • Mark conda.env.env.Environment as pending deprecation in 26.9. Use conda.env.env.EnvironmentYaml instead. (#14981)
  • Mark conda.cli.common.arg2spec as pending deprecation, to be removed in 26.9. (#15028)
  • Mark conda.cli.common.specs_from_args keyword argument json as pending deprecation, to be removed in 26.9. (#15028)
  • Mark conda.gateways.disk.create.create_application_entry_point as pending deprecation, to be removed in 26.9. (#15062)
  • Mark conda.gateways.disk.create.ProgressFileWrapper as pending deprecation, to be removed in 26.9. (#15062)
  • Mark conda.gateways.disk.create.create_fake_executable_softlink as pending deprecation, to be removed in 26.9. (#15062)
  • Postpone conda.env.specs.binstar deprecation to 26.9. (#15062)

Docs

  • Add documentation for conda export command with examples and format specifications. (#14886)
  • Add environment exporter plugin development guide with examples and best practices. (#14886)
  • Update environment management documentation to highlight new export capabilities. (#14886)
  • Update cheatsheet with new export formats and commands. (#14886)
  • Enhance command comparison table to include new export functionality. (#14886)
  • Add glossary entries for CEP 23, environment exporters, explicit format, and requirements format. (#14886)
  • Add note about enhanced conda export functionality alongside existing conda env export. (#14886)
  • Add docs about environment spec plugin detection. (#14918)
  • No longer claim that noarch/repodata.json.bz2 is required. Conda has not used repodata.json.bz2 for years. (#14965)

Other

  • Delay environment activation in dev setup to avoid issues when default_activation_env is set. (#14910)
  • Environment Spec plugins should return an Environment model. (#14937)
  • EnvironmentConfig lists of values should be tuples. (#15000)
  • Avoid modifying tests/env/support in test suite and confusing subsequent test runs. (#15011)
  • Remove unused import of deprecated DumpEncoder. (#15015)

Contributors

25.5.1

25.5.1 (2025-06-05)

Bug fixes

  • Allow conda config commands to process aliased settings names by forwarding them to the canonical name (e.g. self_update -> auto_update_conda). (#14899 via #14898)

Docs

  • Mark environment spec hooks and types as experimental (#14900)

Contributors

25.5.0

25.5.0 (2025-05-21)

Enhancements

  • Add the ability to define pre- and post-transaction hooks. (#14754)
  • Adds support for showing and manipulating settings registered via the settings plugin hook to conda config. (#13661 via #14510)
  • Raise conda.exceptions.OfflineError instead of generic RuntimeError when --offline is used for better error handling. (#14664 via #14665)
  • Add context.default_activation_env setting, which allows users to customize which environment should get auto activated on initialization (if context.auto_activate is enabled), as well as conda activate calls without arguments. Defaults to base. (#14666)
  • Provide conda init --condabin, which only adds the $CONDA_PREFIX/condabin directory to the PATH environment variable instead of installing a shell function. (#14703)
  • Add environment_specifiers plugin hooks to allow the creation of plugins to read different file formats and sources. (#14710)
  • Extend PrefixData API with two constructors (from_name(), from_context()), a new property (name), several boolean-returning methods (exists(), is_environment(), is_base()), and a few exception-raising methods (assert_exists(), assert_environment(), assert_writable(), validate_path(), validate_name()). An additional method set_nonadmin() allows to plant the .nonadmin marker on Windows. (#14747 via #14750)
  • Add support for frozen environment markers (CEP 22). (#14746 via #14766)
  • Add a plugin hook for PrefixData loaders and use it to wrap the existing PyPI interoperability features. These are now present in conda.plugins.prefix_data_loaders.pypi. (#14780)
  • Add a --fields flag to conda list that allows to customize the content of the human output format. (#14781)
  • Add debug logs to get visibility into environment spec plugin selection. (#14815)
  • Add conda.models.records.SolvedRecord class. It is a PackageRecord subclass augmented with the requested_spec field originally found in PrefixRecord. (#14821)

Bug fixes

  • Cleanup references to DepsModifier.UPDATE_SPECS. (#14807)
  • Report package variant installation as "REVISED" as opposed to "DOWNGRADED". (#13797 via #14727)
  • Add a validation step to check if the target environment is writable when running the install or update commands. (#12561 via #14668)
  • Fix cache key in PrefixData. It will now consider interoperability. (#14750)
  • Do not cache PrefixData records across successive conda list invocations. (#14750)
  • environment.yaml spec plugin should only handle yaml files (files with .yaml or .yml file extensions). (#14823)
  • Fix conda info rendering to display components in a consistent order. (#14829 via #14831)

Deprecations

  • Mark conda.base.context.context.auto_activate_base as pending deprecation. Use conda.base.context.context.auto_activate instead. It will be permanently removed in 26.3. (#14666)
  • Mark conda.base.context.Context.pip_interop_enabled as pending deprecation, to be removed in 26.3. Use conda.base.context.Context.prefix_data_interoperability. instead. (#14750)
  • Mark conda.base.context._first_writable_envs_dir as pending deprecation. Use conda.gateways.disk.create.first_writable_envs_dir() and PrefixData.from_name() instead. It will be permanently removed in 26.3. (#14750)
  • Mark conda.base.context.validate_prefix_name as pending deprecation. Use PrefixData.validate_name() and PrefixData.from_name() instead. It will be permanently removed in 26.3. (#14750)
  • Mark conda.cli.common.validate_prefix as pending deprecation. Use PrefixData.assert_environment() instead. It will be permanently removed in 26.3. (#14750)
  • Mark conda.cli.common.validate_prefix_is_writable as pending deprecation. Use PrefixData.assert_writable() instead. It will be permanently removed in 26.3. (#14750)
  • Mark conda.cli.install.check_prefix as pending deprecation. Use PrefixData.exists(), PrefixData.validate_path(), PrefixData.validate_name() instead. It will be permanently removed in 26.3. (#14750)
  • Mark conda.cli.install.print_activate as pending deprecation. Use conda.cli.common.print_activate instead. It will be permanently removed in 26.3. (#14670)
  • Mark conda.cli.install.validate_new_prefix as pending deprecation. Use PrefixData.exists() and PrefixData.validate_path() instead. It will be permanently removed in 26.3. (#14750)
  • Mark conda.cli.install.validate_prefix_exists as pending deprecation. Use PrefixData.exists() instead. It will be permanently removed in 26.3. (#14750)
  • Mark conda.cli.main_info.get_info_components as pending deprecation to be removed in 26.3. Use conda.cli.main_info.iter_info_components instead. (#14837)
  • Mark conda.cli.main_rename.check_protected_dirs as pending deprecation. Use PrefixData.validate_path() instead. It will be permanently removed in 26.3. (#14750)
  • Mark conda.cli.main_rename.validate_src as pending deprecation. Use PrefixData.validate_path() and PrefixData.validate_name() instead. It will be permanently removed in 26.3. (#14750)
  • Mark conda.common.pkg_formats.python module as pending deprecation, to be removed in 26.3. Use conda.plugins.prefix_data_loaders.pypi.pkg_format instead. (#14798)
  • Mark conda.common.pkg_formats subpackage as pending deprecation, to be removed in 26.3. Use the prefix_data_loaders plugin hook instead. (#14798)
  • Mark conda.common.url.hex_octal_to_int as pending deprecation. Use int(..., 16) instead. It will be permanently removed in 26.3. (#14750)
  • Mark conda.core.link.PrefixActionGroup as pending deprecation. Use conda.core.link.PrefixActions instead. It will be permanently removed in 26.3. (#14754)
  • Mark conda.core.link.PrefixActions as deprecated. It will be renamed to conda.core.link.PrefixActionGroup in 26.3. (#14754)
  • Mark conda.core.path_actions._Action as pending deprecation. Use conda.core.path_actions.Action instead. It will be permanently removed in 26.3. (#14754)
  • Mark conda.core.prefix_data.get_python_version_for_prefix() as pending deprecation, to be removed in 26.3. Use conda.core.prefix_data.PrefixData(prefix).get("python").version instead. (#14750)
  • Mark conda.core.prefix_data.PrefixData keyword argument pip_interop_enabled as pending deprecation, to be removed in 26.3. Use the interoperability keyword argument instead. (#14750)
  • Mark conda.core.prefix_data.PrefixData._load_site_packages() as pending deprecation, to be removed in 26.3. Use conda.plugins.prefix_data_loaders.pypi.load_site_packages() instead. (#14750)
  • Mark conda.core.prefix_data.PrefixData._python_pkg_record as pending deprecation, to be removed in 26.3. Use PrefixData.get("python") instead. (#14750)
  • Mark conda.core.prefix_data.python_record_for_prefix() as pending deprecation. Use conda.core.prefix_data.PrefixData(prefix).get("python") instead. (#14750)
  • Mark conda.gateways.disk.read.read_python_record as pending deprecation, to be removed in 26.3. Use conda.plugins.prefix_data_loaders.pypi.pkg_format.read_python_record instead. (#14798)
  • Mark conda.gateways.disk.test.is_conda_environment as pending deprecation. Use PrefixData.is_environment() instead. It will be permanently removed in 26.3. (#14750)
  • Mark conda.gateways.disk.test.touch_nonadmin as pending deprecation. Use PrefixData.set_nonadmin() instead. It will be permanently removed in 26.3. (#14750)
  • Mark conda.models.records.PackageRecord.schannel as pending deprecation. Use conda.models.records.PackageRecord.channel_name instead. It will be permanently removed in 26.3. (#14781)
  • Mark conda.trust.signature_verification and conda.trust.constants modules for deprecation in version 25.9.0, to be removed in version 26.3.0. The functionality will be moved to conda-content-trust and conda-anaconda-trust-root packages respectively. (#14849)
  • Mark conda info --license as pending deprecation to be removed in 26.3. (#14831)
  • Mark conda info --root as pending deprecation to be removed in 26.3. Use conda info --base instead. (#14831)

Docs

  • Add type hints and docstrings to conda.core.portability. (#13820)
  • Add type hints and docstrings to conda.core.subdir_data. (#13821)
  • Add type hints to conda.base.constants. (#13480)
  • Add type hints to conda.base.context. (#14776)
  • Add type hints to conda.__init__, conda.exceptions and conda.exception_handler. (#14776)
  • Add type hints to conda.core.prefix_data. (#14779)
  • Add examples to environment specs plugin docs. (#14814)
  • Add type hints to conda.models.channel.Channel. (#14817)
  • Update the conda cheatsheet to 25.3.1 version. (#14830)

Other

  • Refactor --repodata-fn iteration in conda.cli.install and other smaller cleanups. (#14670)
  • Refactor command line argument validations from conda.cli.install.install to the relevant cli modules. (#14742)
  • Refactor conda create --clone logic into a separate function. (#14743)
  • Use dict.fromkeys for sequence deduplication, instead of IndexedSet(). (#14777)

Contributors

New Contributors

25.3.1