# Miniconda

Minimal conda and Python installer for isolated project environments and command-line package management.

> This is the Markdown version of the Miniconda page on OpenNavo, with the same facts as the web page: <https://opennavo.com/apps/miniconda>

- **Latest version**: `py314_26.9.4-1`
- **Developer**: Anaconda, Inc.
- **Homepage**: <https://www.anaconda.com/docs/getting-started/miniconda/main>
- **Categories**: [Languages & Runtimes](https://opennavo.com/categories/languages)
- **Install**: `brew install --cask miniconda`
- **30-day installs**: 2,545
- **Homebrew**: Available; the app updates itself
- **Download URL**: <https://repo.anaconda.com/miniconda/Miniconda3-py314_26.9.4-1-MacOSX-arm64.sh>
- **SHA-256**: `205be72fe8a81c95e92504fa22d7e19a3411ec09939196100457ba77e66cd761`
- **Commands**: conda

SHA-256 only checks that the download is complete; it is not a security certification.

## Caveats

Please run the following to setup your shell: conda init "$(basename "${SHELL}")" Alternatively, manually add the following to your shell init: eval "$(conda "shell.$(basename "${SHELL}")" hook)"

## Installation and removal contents

```json
[
  {
    "declaration": {
      "uninstall_preflight_steps": [
        {
          "steps": [
            {
              "guards": [
                {
                  "condition": "if_exists",
                  "id": "1",
                  "path": "{{caskroom_path}}/base/envs"
                }
              ],
              "overwrite": true,
              "source": {
                "base": "caskroom_path",
                "path": "base/envs"
              },
              "target": {
                "path": "{{temp}}/{{token}}-envs"
              },
              "type": "move"
            }
          ]
        }
      ]
    },
    "phase": "uninstall",
    "sources": [],
    "type": "uninstall_preflight_steps"
  },
  {
    "declaration": {
      "uninstall": [
        {
          "delete": "$HOMEBREW_PREFIX/Caskroom/miniconda/base"
        }
      ]
    },
    "phase": "uninstall",
    "sources": [],
    "type": "uninstall"
  },
  {
    "declaration": {
      "installer": [
        {
          "script": {
            "args": [
              "-b",
              "-p",
              "$HOMEBREW_PREFIX/Caskroom/miniconda/base"
            ],
            "executable": "Miniconda3-py314_26.9.4-1-MacOSX-arm64.sh"
          }
        }
      ]
    },
    "phase": "install",
    "sources": [],
    "type": "installer"
  },
  {
    "declaration": {
      "binary": [
        "$HOMEBREW_PREFIX/Caskroom/miniconda/base/condabin/conda"
      ],
      "target": "$HOMEBREW_PREFIX/bin/conda"
    },
    "phase": "install",
    "sources": [
      "$HOMEBREW_PREFIX/Caskroom/miniconda/base/condabin/conda"
    ],
    "target": "$HOMEBREW_PREFIX/bin/conda",
    "type": "binary"
  },
  {
    "declaration": {
      "postflight_steps": [
        {
          "steps": [
            {
              "guards": [
                {
                  "condition": "if_exists",
                  "id": "1",
                  "path": "{{temp}}/{{token}}-envs"
                }
              ],
              "paths": [
                {
                  "base": "caskroom_path",
                  "path": "base/envs"
                }
              ],
              "recursive": true,
              "type": "remove"
            },
            {
              "guards": [
                {
                  "condition": "if_exists",
                  "id": "1",
                  "path": "{{temp}}/{{token}}-envs"
                }
              ],
              "overwrite": true,
              "source": {
                "path": "{{temp}}/{{token}}-envs"
              },
              "target": {
                "base": "caskroom_path",
                "path": "base/envs"
              },
              "type": "move"
            }
          ]
        }
      ]
    },
    "phase": "install",
    "sources": [],
    "type": "postflight_steps"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": [
            "/private/tmp/miniconda-envs",
            "~/.conda",
            "~/.condarc",
            "~/.continuum"
          ]
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## About

Miniconda is Anaconda's minimal installer for conda, Python and the dependencies needed to run them. It provides a command-line starting point for developers, data scientists and automation users who want to install only the packages each project needs. It does not include Anaconda Navigator or the broad preinstalled data-science collection of Anaconda Distribution.

### Main features
- Create separate environments with different Python and package versions.
- Install, update and remove packages with dependency resolution through conda.
- Activate project environments without replacing the macOS system Python.
- Choose package channels and manage repository access according to their terms.
- Export and recreate environment specifications for development and automation.
- Use a compact base installation, then add scientific, development or other packages as needed.

### Installation and first use
Install this Mac cask with `brew install --cask miniconda`. It installs into Homebrew's Caskroom base directory and links the conda command. Follow the cask's shell-setup guidance; for zsh, run `conda init zsh`, then reopen Terminal. Check installation with `conda list`. For example, create a separate project environment with `conda create -n myproject python=3.14`, activate it using `conda activate myproject`, and install the packages your project requires. These are usage instructions, not operations performed by this catalog.

The official shell or graphical installer is an alternative to Homebrew, with a different default installation location. Avoid confusing an existing Anaconda, Miniforge or Miniconda prefix with the cask-managed installation. Review and accept the relevant installer and repository terms. Keep project environments separate from base. Package downloads generally require network access; optional private repositories require their own credentials.

### Requirements, dependencies and conflicts
Current official Miniconda installers support Apple Silicon Macs running macOS 12.1 or later. The recorded Apple Silicon cask version `py314_26.7.1-1` selects the Python 3.14 installer containing Python 3.14.7 and conda 26.7.1. Its ARM64 shell installer is 155,681,303 bytes; this is download size, not installed disk use.

Anaconda ended new Intel macOS installer releases after the 25.7.x line. Homebrew's Intel variation therefore remains `py313_25.7.0-2`, rather than matching the current Apple Silicon version. Do not assume the latest ARM64 release is an Intel-native download. Older archived installers have their own compatibility limits.

The Homebrew cask explicitly conflicts with `miniforge` and declares no additional formula dependency. Its raw macOS dependency field does not establish the vendor's current OS support policy. Official system requirements list a minimum 400 MB to download and install; the current comparison page estimates roughly 900 MB for an installed Miniconda base, and environments/packages need additional space. No universal RAM requirement was established.

Official non-Mac installers cover Windows 64-bit x86 and Linux x86-64/aarch64. Current Linux installers require glibc 2.28 or newer; aarch64 builds target server-class hardware and may not suit every Raspberry Pi. Consult the current system-requirements page for Windows and distribution support.

### Accounts, fees and licensing
The Miniconda installer is available without a separate installer purchase, but its EULA and package licenses apply. Conda itself is an open-source component; that does not make every bundled package or repository service subject to the same license. Access to Anaconda's repositories/platform can require a paid subscription. Current terms require a Business Plan for use on behalf of a for-profit organization with more than 200 employees or contractors, including affiliates, unless an applicable exception qualifies it for free use. Personal non-commercial use, qualifying academic/non-profit use and eligible smaller businesses have defined free-use provisions. Review the full current terms and organizational eligibility before choosing channels.

An account is not inherently required to create and use local conda environments. Anaconda's web download flow asks for registration, and authenticated platform/private-repository features need appropriate credentials. The installer EULA explicitly prohibits bypassing repository payment requirements.

The icon is Anaconda's official publisher brand symbol. The media example comes from official Miniconda Windows installation documentation: it shows opening Anaconda Prompt on Windows 11, not a macOS interface or a GUI bundled with the Mac cask.

Sources: [Miniconda overview](https://www.anaconda.com/docs/getting-started/concepts/anaconda-or-miniconda), [System requirements](https://www.anaconda.com/docs/getting-started/miniconda/system-requirements), [Installation](https://www.anaconda.com/docs/getting-started/miniconda/install), [Official installer archive](https://repo.anaconda.com/miniconda/), [Miniconda EULA](https://www.anaconda.com/legal/terms/miniconda), [Anaconda terms](https://www.anaconda.com/legal/terms/terms-of-service), [Conda documentation](https://docs.conda.io/projects/conda/en/stable/).

## System requirements

- Build for macOS 27, 26, 15, 14, 13, 12, 11 · Version: py313_25.7.0-2 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/miniconda.rb> · Checked 2026-11-22
  - <https://repo.anaconda.com/miniconda/Miniconda3-py313_25.7.0-2-MacOSX-x86_64.sh>
  - SHA-256: `9c88674b1a839eeb4cff006df397a05ea7d896472318fd84b7070278f9653dc6`
- Build for macOS 27, 26, 15, 14, 13, 12, 11 · Version: py314_26.9.4-1 · Apple silicon · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/miniconda.rb> · Checked 2026-11-22
  - <https://repo.anaconda.com/miniconda/Miniconda3-py314_26.9.4-1-MacOSX-arm64.sh>
  - SHA-256: `205be72fe8a81c95e92504fa22d7e19a3411ec09939196100457ba77e66cd761`

## Miniconda security facts

Only facts that can be checked, each with its source and date. This is not a safety certification. To check the files you downloaded, scan them on your Mac with OpenNavo.

- <https://github.com/conda/conda> · Open source: Yes — <https://github.com/conda/conda> · Checked 2026-11-13

## Uninstall

- `brew uninstall --cask miniconda`

A regular uninstall removes the app and keeps its settings and caches.

### Uninstalling also removes

- Files and folders: `$HOMEBREW_PREFIX/Caskroom/miniconda/base` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/miniconda.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.

### Deep clean (optional)

- `brew uninstall --zap --cask miniconda`

`--zap` also deletes the settings, caches and other files listed in the Homebrew definition. They can include data shared with other apps and cannot be restored, and it does not guarantee that nothing is left. Back up any data you need first. To keep settings and caches, leave out `--zap`.

A regular uninstall removes the app and keeps its settings and caches.

- Files and folders: `/private/tmp/miniconda-envs` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/miniconda.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/.conda` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/miniconda.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/.condarc` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/miniconda.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/.continuum` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/miniconda.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.

## Latest release notes

### 26.10.0 (2026-11-06)

##### ✨ Special announcement ✨

This is an announcement about an important change in conda's functionality:

###### **With this 26.10.0 release we are changing the default solver of conda to [`conda-rattler-solver`](https://github.com/conda/conda-rattler-solver)!** 🥳 🚀

The previous default, the `libmamba` solver, remains available as an alternative, as does the `pycosat` solver (also known as `classic`). The `classic` solver now ships as the separate [`conda-pycosat-solver`](https://github.com/conda/conda-pycosat-solver) plugin, which is bundled with conda. Existing `solver: classic` settings and `--solver=classic` commands keep working, and the plugin also accepts `--solver=pycosat`.

###### Why are we switching the solver?

In short: to make conda faster and more accurate.

Rattler is a set of Rust libraries for working with conda packages. The `conda-rattler-solver` plugin uses rattler's dependency solver and optimized sparse repodata parsing, which reduces overhead when resolving complex dependency trees. It solves environments faster than libmamba, with the largest improvements on large or heavily constrained environments.

Conda 26.10.0 switches to rattler for fresh installations and upgrades that do not have an explicit solver setting. If you have already selected a solver, conda keeps that choice.

###### What can I do if this update doesn't work for me?

If the new solver is not working as you expect:

- Check if the behavior you are observing is a [known limitation](https://conda.github.io/conda-rattler-solver/user-guide/known-limitations/) or a deliberate change.
- If that's not the case, please submit a bug report or feature request in the [conda-rattler-solver repository](https://github.com/conda/conda-rattler-solver/issues/new/choose).
- If necessary, you can go back to using the `libmamba` solver without modifying your conda installation:
  - When possible, pass the command line option `--solver=libmamba` to your `conda` calls.
  - Otherwise (e.g. for `conda build ...` or `constructor ...`), set the environment variable `CONDA_SOLVER=libmamba`.
  - For permanent changes, use the conda configuration system: `conda config --set solver libmamba`.
- The `pycosat` solver (also known as `classic`) remains available with `--solver=pycosat` or `--solver=classic`.

###### Where can I learn more about conda-rattler-solver?

The documentation of the `conda-rattler-solver` plugin can be found at [conda.github.io/conda-rattler-solver](https://conda.github.io/conda-rattler-solver/), including the [known limitations and differences](https://conda.github.io/conda-rattler-solver/user-guide/known-limitations/), and in the [conda solvers guide](https://docs.conda.io/projects/conda/en/latest/user-guide/concepts/solvers.html).

##### Enhancements

* IMPORTANT: Set `solver: rattler` as the new default solver, including after upgrades when no solver is explicitly configured. Require `conda-rattler-solver >=26.10.2`. (#16853 via #16944)
* Track the last time an environment was activated via user invocation. Activation modifies the mtime of `<prefix>/conda-meta/last_activated` (best-effort; failures are ignored). The timestamp is exposed as `last_activated` in JSON output. (#14308 via #16808)
* Add an `is_active` property to `PrefixData`. (#14308 via #16808)
* Add `--disable-plugins` to selectively disable plugins at runtime using comma-separated names or by repeating the option. Keep `--no-plugins` as a boolean flag to disable all external plugins. (#15914 via #15915)
* Add `--enable-plugins` to keep selected plugins enabled when using `--no-plugins` or `CONDA_NO_PLUGINS`, including solver plugins needed for recovery. (#15914 via #15915)
* Add a `root_extras` option to `conda._private.shards.subset.build_repodata_subset` (and the underlying `RepodataSubset.reachable*` methods) so callers can request that CEP 44 `extra_depends` groups be fetched only for specific root/user-requested packages, without recursing into extras of their dependencies. (#16724 via #16742)
* Add `LinkSourceNotFoundError` and `LinkScriptError` (a `LinkError` subclass) so callers can detect a missing package cache source and a failed pre-/post-link script with `isinstance` and inspect `src`, `action`, `prec`, and `path` instead of parsing error messages. Error text is unchanged, and `LinkScriptError` remains catchable as `LinkError`, but code that matched the missing-source case against a bare `CondaError` now needs `LinkSourceNotFoundError`. (#16785 via #16747)
* Follow CEP 44 extras explicitly requested by dependency specs (e.g. `pkg[extras=more]`) when fetching sharded repodata, and revisit a package when another dependency activates an additional extras group. Groups that were not requested stay inactive. Previously only extras requested for root packages via `root_extras` were followed. (#16891 via #16908)
* Parse `MatchSpec` strings with the v3 parser for all solvers, not just for `rattler`. This keeps complete `extras` and `flags` lists (e.g. `httpx2[extras=[cli,http2]]` or `httpx2[extras=cli,http2]`) and accepts nested `when` expressions. (#16724 via #16906)

##### Bug fixes

* Preserve platform-named parent directories when parsing channel and package URLs, fixing conda-build failures with paths such as `osx-arm64/conda-bld`. (conda/conda-libmamba-solver#1108 via #16926)
* Preserve nested shard URLs when adding stored Anaconda tokens. (#16946 via #16948)
* Avoid `FileNotFoundError` on Windows when `rmtree()` deletes a directory that `RD /S /Q` already removed (for example during `conda package` temp cleanup). (#16539 via #16803)
* Write configuration files atomically when directory permissions allow, preserve macOS ACLs, and reject writes if the file changed in the meantime. Keep writable files editable in read-only directories, with best-effort recovery after write failures. (#16694 via #16695)
* Ask once before `conda env remove` and `conda remove --all` delete an environment. Those commands previously confirmed the package unlink and then, after the packages were already uninstalled, asked again before deleting the rest of the prefix, including non-conda files. Declining that second prompt left a half-deleted environment. The package plan and the prefix-deletion warning are now shown together before anything is removed, and declining leaves the environment unchanged. (#16753 via #16852)
* Fix `conda config --get` writing to the config file when no key is given. (#16825 via #16831)
* Fix `iter_records_v3()` not converting raw-bytes hashes (`sha256`, `md5`, `legacy_bz2_md5`, `attestations_sha256`) to hex strings, as written by e.g. `rattler-index`. (#16866)
* Retry remote requests that fail with HTTP 502 (Bad Gateway) or 504 (Gateway Timeout), which are usually transient server or CDN errors. (#16848)
* Fix `ObjectParameter` configuration types not expanding environment variables when `expandvars=True`. (#16897)
* Fix `conda.deprecations.deprecated` and `conda.deprecations.deprecated.argument` to preserve generator functions when decorating, instead of wrapping them in a plain function and losing generator semantics (e.g. `pytest` yield-fixtures now warn and yield correctly when stacked under `@pytest.fixture`). (#16900)
* Use a fresh YAML parser for every read and write to prevent concurrent calls and failed operations from corrupting later results. (#16943 via #16949)
* Show environment names in PowerShell prompts for canary packages built with `changeps1: false`. (#16858)

##### Deprecations

* Mark `conda.plugins.solvers`, `conda.resolve`, `conda.common.logic`, and `conda.common._logic` as pending deprecation, to be removed in 27.9. Use [`conda-pycosat-solver`](https://github.com/conda/conda-pycosat-solver) instead. (#14170 via #16520)
* Mark `conda.models.prefix_graph.GeneralGraph` and its `breadth_first_search_by_name` method as pending deprecation, to be removed in 27.9. (#16802)
* Mark `conda.testing.cases` as pending deprecation, to be removed in 27.9. Use native `pytest` fixtures instead. (#16900)
* Mark `conda.testing.helpers.assert_equals`, `assert_in`, and `assert_not_in` as pending deprecation, to be removed in 27.9. Use a plain `assert` instead. (#16900)
* Mark `conda.testing.helpers.supplement_index_with_repodata` as pending deprecation, to be removed in 27.9. Use `conda.models.records.PackageRecord.from_objects` instead. (#16900)
* Mark `conda.testing.helpers.add_feature_records_legacy` as pending deprecation, to be removed in 27.9. (#16900)
* Mark `conda.testing.integration.Commands` as pending deprecation, to be removed in 27.9. Use the `conda_cli` fixture instead. (#16900)
* Mark `conda.testing.integration.escape_for_winpath` as pending deprecation, to be removed in 27.9. Use `re.escape` instead. (#16900)
* Mark the `conda.testing.integration` constants `UNICODE_CHARACTERS`, `UNICODE_CHARACTERS_RESTRICTED`, `SPACER_CHARACTER`, and `cp_or_copy` as pending deprecation, to be removed in 27.9. (#16900)
* Mark `conda.testing.solver_helpers.temp_simple_env` as pending deprecation, to be removed in 27.9. Use `conda.testing.solver_helpers.SimpleEnvironment` instead. (#16900)
* Mark `conda.models.match_spec._parse_spec_str` as pending deprecation, to be removed in 27.9. Use `conda.models.match_spec._parse_spec_str_v3` instead. (#16724 via #16906)
* Mark the unused `conda.core.subdir_data.SubdirData` pickle cache helpers and the `cache_path_pickle` property as pending deprecation, to be removed in 27.9. (#16928)

##### Docs

* Document the `last_activated` timestamp in the JSON output. (#14308 via #16808)
* Add a "Rendering output" deep dive documenting the reporter backend as the output system for the conda CLI, with logging and error handling guidelines. (#16700 via #16843)
* Document logging guidelines for library code in the logging deep dive. (#16701 via #16912)
* Add a guide to choosing a solver to the documentation, with information about the available solvers and how to change your solver. (#16844)

##### Other

* Move the classic solver out of conda core and into the standalone [`conda-pycosat-solver`](https://github.com/conda/conda-pycosat-solver) plugin, bundled with conda by default. Both `--solver=pycosat` and `--solver=classic` continue to work unchanged. (#14170 via #16520)
* Keep PowerShell CI installations separate from PowerShell's runtime cache. (#16762 via #16907)
* Add `tmp_repodata_channel` for constructing local test channels from in-memory package metadata. (#16807)
* Replace production-channel inputs in `test_neutering_of_historic_specs` with a small local channel while preserving historical-spec regression coverage. (#16767 via #16807)
* Speed up `test_cross_channel_incompatibility` by using two small local channels instead of remote conda-forge/defaults metadata, preserving optional-constraint regression coverage. (#16768 via #16796)
* Raise the minimum Python version required to run conda to 3.11, following [conda-build#6176](https://github.com/conda/conda-build/issues/6176). Conda can still create and manage environments containing Python 3.10 and older; this only affects the interpreter used to run conda itself. (#16795 via #16801)
* Do not allow local condarc files to populate the `context_testdata` fixture. (#16797 via #16809)
* Warn when a `conda doctor` reinstall attempt fails due to malformed `conda-meta` data. (#16636 via #16834)
* Convert raw-bytes hash digests to hex strings in memory when sharded repodata is decoded, rather than re-converting records on each read. (#16868)

##### Contributors

* @aditya0929 made their first contribution in <https://github.com/conda/conda/pull/16831>
* @conda-bot
* @danyeaw
* @dependabot[bot]
* @dholth
* @ForgottenProgramme
* @gavinw2143 made their first contribution in <https://github.com/conda/conda/pull/16796>
* @jezdez
* @kathatherine
* @kenodegard
* @larsoner made their first contribution in <https://github.com/conda/conda/pull/16848>
* @pre-commit-ci[bot]
* @r3wretrhy made their first contribution in <https://github.com/conda/conda/pull/16803>
* @ryanskeith
* @soapy1
* @travishathaway
* @VINAYRAO0406 made their first contribution in <https://github.com/conda/conda/pull/16814>

**Full Changelog**: https://github.com/conda/conda/compare/26.9.3...26.10.0

## Facts and sources

- <https://opennavo.com/apps/miniconda>
- <https://opennavo.com/apps/miniconda/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/miniconda.rb> · Checked 2026-11-22
- <https://formulae.brew.sh/cask/miniconda>
- <https://github.com/conda/conda> · Checked 2026-11-13
