# Miniforge

Minimal Conda and Mamba installer preconfigured for conda-forge, with isolated package environments and native multi-platform installers.

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

- **Latest version**: `26.9.4-2`
- **Developer**: conda-forge community
- **Homepage**: <https://github.com/conda-forge/miniforge>
- **Categories**: [Languages & Runtimes](https://opennavo.com/categories/languages)
- **Install**: `brew install --cask miniforge`
- **30-day installs**: 2,289
- **Homebrew**: Available; the app updates itself
- **Download URL**: <https://github.com/conda-forge/miniforge/releases/download/26.9.4-2/Miniforge3-26.9.4-2-MacOSX-arm64.sh>
- **SHA-256**: `fb567612b76f4ef46de326f04425dbe381b6afc6a66c545f5043255a5ef34258`
- **Commands**: conda, mamba

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}")"

## 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/miniforge/base"
        }
      ]
    },
    "phase": "uninstall",
    "sources": [],
    "type": "uninstall"
  },
  {
    "declaration": {
      "installer": [
        {
          "script": {
            "args": [
              "-b",
              "-p",
              "$HOMEBREW_PREFIX/Caskroom/miniforge/base"
            ],
            "executable": "Miniforge3-26.9.4-2-MacOSX-arm64.sh"
          }
        }
      ]
    },
    "phase": "install",
    "sources": [],
    "type": "installer"
  },
  {
    "declaration": {
      "binary": [
        "$HOMEBREW_PREFIX/Caskroom/miniforge/base/condabin/conda"
      ],
      "target": "$HOMEBREW_PREFIX/bin/conda"
    },
    "phase": "install",
    "sources": [
      "$HOMEBREW_PREFIX/Caskroom/miniforge/base/condabin/conda"
    ],
    "target": "$HOMEBREW_PREFIX/bin/conda",
    "type": "binary"
  },
  {
    "declaration": {
      "binary": [
        "$HOMEBREW_PREFIX/Caskroom/miniforge/base/condabin/mamba"
      ],
      "target": "$HOMEBREW_PREFIX/bin/mamba"
    },
    "phase": "install",
    "sources": [
      "$HOMEBREW_PREFIX/Caskroom/miniforge/base/condabin/mamba"
    ],
    "target": "$HOMEBREW_PREFIX/bin/mamba",
    "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/miniforge-envs",
            "~/.conda",
            "~/.condarc"
          ]
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## About

Miniforge is a minimal installer for Conda and Mamba preconfigured for the conda-forge community package channel. It suits developers, scientific-computing users and data analysts who want isolated environments rather than modifying a system Python installation. It is a command-line environment-management distribution, not a graphical application store or a full scientific-software bundle.

### Main features
- Install Conda, Mamba and their dependencies into a managed base environment.
- Create isolated project environments with their own Python and package versions.
- Resolve and install packages from conda-forge, the default and only configured channel.
- Activate environments from supported shells after initialization.
- Use native installers for multiple operating systems and CPU architectures.
- Use interactive or documented batch installation workflows, with separate macOS PKG options.

### Install and start
This catalog's Mac cask can be installed with `brew install --cask miniforge`, but upstream explicitly does not recommend Homebrew installation: its repackaging can introduce incompatibilities that upstream does not test. If you prefer upstream's supported installer workflow, choose the official `.sh` or macOS `.pkg` matching your architecture and follow the README. Do not install competing distributions into the same prefix.

After installation, initialize the shell you use when needed (for example, `conda init zsh` for zsh), then restart the shell. The current cask includes a shell-initialization caveat; batch upstream installation does not initialize Conda automatically. Initialization changes shell configuration and can activate the base environment by default, changing which `python` runs. Create a named environment for project dependencies, such as `conda create --name my_project python=3.13`, then activate it with `conda activate my_project`. Upstream documents disabling automatic base activation with `conda config --set auto_activate_base false`.

Manage packages through the environment tools deliberately; mixing unrelated distributions, global PATH changes and overlapping prefixes can cause conflicts. Before uninstalling, review environment data and shell initialization rather than deleting an uncertain directory.

### Versions, packages and channels
The current 26.7.2-0 installer recipe pins Conda 26.7.2, Mamba 2.9.0, conda-libmamba-solver 26.7.0 and Python 3.14 in base. This installer release identifier is not the version of every bundled component. Version 26.5.3-0 changed base Python from 3.13 to 3.14; 26.3.2-3 was the last release with Python 3.13 in base. Other environments can use different supported Python versions and implementations, so base Python does not lock every project to 3.14.

Base packages come from conda-forge and the configured channel is conda-forge, not Anaconda's default channel. The recipe also defines conda-forge mirrors; this does not imply that every custom channel has the same terms or package availability. Additional tools such as JupyterLab, NumPy and pandas are installed into chosen environments as needed rather than assumed to be bundled.

### Requirements, dependencies and platforms
Current official installers require macOS 11 Big Sur or newer for Intel x86-64 and Apple Silicon ARM64. The README labels Apple Silicon and Linux RISC-V builds experimental with less testing. Linux x86-64, ARM64 and POWER 8/9 ppc64le require glibc 2.17+; the new Linux riscv64 target requires glibc 2.29+. Windows x86-64 requires Windows 10+; upstream does not establish the exact earliest Windows 10 build. A 64-bit Raspberry Pi installation needs a 64-bit OS. No 32-bit/mobile installer is established here.

The Homebrew cask conflicts with `miniconda`; select one rather than installing both casks together. A separate system Python, Homebrew Python formula or compiler is not a universal requirement for the bundled installer. Some packages need their own hardware, operating-system features or external dependencies. No universal RAM or installed-space minimum was confirmed: installed environments and package caches determine storage needs.

The official 26.7.2-0 Apple Silicon shell installer is 83,747,533 bytes from GitHub release asset metadata, matching the production package; this is transfer size, not installed space. The installer includes bootstrap/base content, while fetching new packages needs network access unless you intentionally provide an offline package setup. No account is required for ordinary public conda-forge environment use; private channels and external services may require their own credentials.

### Price and license
Miniforge is free and its installer code uses BSD 3-Clause. Bundled packages and the temporary bootstrap executable have their own licenses; review the installer license and individual package notices, especially for redistribution. Downloading Miniforge does not grant a blanket license to all possible third-party packages or paid services.

Sources: [Official README and installation caveats](https://github.com/conda-forge/miniforge), [Current release](https://github.com/conda-forge/miniforge/releases/tag/26.7.2-0), [Version-specific recipe](https://github.com/conda-forge/miniforge/blob/26.7.2-0/Miniforge3/construct.yaml), [License](https://github.com/conda-forge/miniforge/blob/main/LICENSE), [conda-forge installer overview](https://conda-forge.org/download/).

## System requirements

- Build for macOS 27, 26, 15, 14, 13, 12, 11 · Version: 26.9.4-2 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/miniforge.rb> · Checked 2026-11-22
  - <https://github.com/conda-forge/miniforge/releases/download/26.9.4-2/Miniforge3-26.9.4-2-MacOSX-x86_64.sh>
  - SHA-256: `30e82ce68875fc50b917a3a541ea0516272866584187f7ea980ce8eaf715807d`
- Build for macOS 27, 26, 15, 14, 13, 12, 11 · Version: 26.9.4-2 · Apple silicon · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/miniforge.rb> · Checked 2026-11-22
  - <https://github.com/conda-forge/miniforge/releases/download/26.9.4-2/Miniforge3-26.9.4-2-MacOSX-arm64.sh>
  - SHA-256: `fb567612b76f4ef46de326f04425dbe381b6afc6a66c545f5043255a5ef34258`

## Miniforge 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-forge/miniforge> · Open source: Yes — <https://github.com/conda-forge/miniforge> · Checked 2026-11-13

## Uninstall

- `brew uninstall --cask miniforge`

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

### Uninstalling also removes

- Files and folders: `$HOMEBREW_PREFIX/Caskroom/miniforge/base` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/miniforge.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 miniforge`

`--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/miniforge-envs` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/miniforge.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/miniforge.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/miniforge.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.9.4-2 (2026-11-06)

Adds Windows ARM64 installer builds and tests.

Miniforge 26.9.4-2 was released on 2026-11-06. This update adds Windows ARM64 installer builds and tests.

- Adds Windows ARM64 installer builds and tests.

The rest of the tag lists CI changes only: a test that conda init works on Windows, running offline tests as soon as the build test passes, and a GitHub Actions dependency bump. Those are not user-facing installer changes.

Source: https://github.com/conda-forge/miniforge/releases/tag/26.9.4-2

## Facts and sources

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