Miniforge
This repository holds the minimal installers for Conda and Mamba specific to conda-forge, with the following features pre-configured:
We put an emphasis on supporting various CPU architectures (x86_64, ppc64le,
and aarch64 including Apple Silicon) as well as the stability of this
installer.
Goals
The goal of this installer is to provide you with an entry point to the
conda and mamba commands. If these two commands execute correctly, then this
installer has achieved its goal.
If you have issues with specific packages, please report them to the
associated feedstock. You may find the feedstock associated with a package using
our website
Usage
Miniforge provides installers for the commands conda and
mamba. Once the installer for your OS
and architecture has been executed, you should be able to use these commands in
a terminal.
conda/mamba usable in any terminals
However, with the default choices of the Windows installer, these commands are
only available in the "Miniforge Prompt". To be able to use these commands in
other terminals, one needs to initialize conda for your shell by running in
the Miniforge Prompt.
conda init
Note that one can also just add the C:\Users\myusername\miniforge3\condabin\ folder
to the path environment variable
manually
so conda and mamba may be used more conveniently from any command prompt with limited
chance of software conflicts.
The same situation arises on Unix if you use the non-interactive install.
Initialization can be done by calling conda with its full path, with something like
~/miniforge3/bin/conda init
Automatic activation of environments
By default, once conda has been initialized for your shell, the base environment is
activated so that the command python corresponds to the base Python provided by
Miniforge and conda install installs packages in the base environment. This can
be convenient for but it is cleaner to deactivate this automatic activation with
conda config --set auto_activate false
and use conda or mamba to create and activate other environments, with for example
(to create an environment called my_project)
conda create --name my_project jupyterlab numpy pandas
conda activate my_project
# Now you can start jupyter lab
jupyter lab
Finally, it is also possible to add to your shell configuration file
(typically ~/.bashrc or ~/.zshrc on Unix;
on Windows, edit with notepad $PROFILE) the activation command.
Requirements and installers
Latest installers with Python 3.14 (*) in the base environment:
| OS | Architecture | Minimum Version | File |
|---|
| Linux | x86_64 (amd64) | glibc >= 2.17 | Miniforge3-Linux-x86_64.sh |
| Linux | aarch64 (arm64) (**) | glibc >= 2.17 | Miniforge3-Linux-aarch64.sh |
| Linux | ppc64le (POWER8/9) | glibc >= 2.17 | Miniforge3-Linux-ppc64le.sh |
| Linux | riscv64 (rv64gc) (***) | glibc >= 2.29 | Miniforge3-Linux-riscv64.sh |
| macOS | x86_64 | macOS >= 11.0 | Miniforge3-MacOSX-x86_64.{sh,pkg} |
| macOS | arm64 (Apple Silicon) (***) | macOS >= 11.0 | Miniforge3-MacOSX-arm64.{sh,pkg} |
| Windows | x86_64 (****) | Windows >= 10 | Miniforge3-Windows-x86_64.exe |
| Windows | arm64 (WoA) (***) | Windows >= 11 | Miniforge3-Windows-arm64.exe |
(*) The Python version is specific only to the base environment. Conda can create new environments with different Python versions and implementations.
(**) For Raspberry PI that include a 64 bit processor, you must also use
a 64-bit operating system such as
Raspberry Pi OS 64-bit
or
Ubuntu for Raspberry PI.
The versions listed as "System: 32-bit" are not compatible with the installers on this website.
(***) Apple silicon, Linux RISC-V , WoA builds are experimental and haven't had testing like the other platforms.
(****) The Windows installer requires Windows 10 or later. However, we are unsure exactly what version of Windows 10.
We need help from users to maintain the backlog of windows questions.
Support for Python 3.13 in the base environment
The base environment switched from Python 3.13 to Python 3.14 in version
26.5.3-0. The last release with Python 3.13 in the base environment is
26.3.2-3, available at
https://github.com/conda-forge/miniforge/releases/tag/26.3.2-3
In most cases you do not need an older installer: as noted in (*) above, the
base environment's Python version does not limit the Python versions you can
install elsewhere, so you can keep the latest installer and create an
environment with the version you need, for example
conda create --name my_project python=3.13
여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗
