ITADN
conda-forge/miniforge
代码 动态 Issues221 合并请求121 版本36
conda-forge/miniforge · 文件 下载 ZIP
文件最后提交记录最后更新时间
README.md
以下内容由 AI 翻译，如有问题请点此提交 issue 反馈

Miniforge

Build miniforge GitHub downloads

本仓库包含专为 conda-forge 定制的 Conda 和 Mamba 最小安装程序，并预配置了以下功能：

我们着重支持各种 CPU 架构（x86_64、ppc64le 以及包括 Apple Silicon 在内的 aarch64）以及该安装程序的稳定性。

目标

此安装程序的目标是为您提供 conda 和 mamba 命令的入口点。如果这两个命令能够正确执行，则该安装程序已达成其目标。

如果您遇到特定软件包的问题，请向相关的 feedstock 报告。您可以通过我们的 网站 找到与某个软件包相关的 feedstock。

用法

Miniforge 提供了 conda 和 mamba 命令的安装程序。 一旦执行了适用于您的操作系统 和架构的安装程序，您就应该能够在 终端中使用这些命令。

在任何终端中均可使用 conda/mamba

但是，使用 Windows 安装程序的默认选项时，这些命令仅在 "Miniforge Prompt" 中可用。为了能够在 其他终端中使用这些命令，需要在 Miniforge Prompt 中运行命令以初始化您的 shell 中的 conda。

conda init

请注意，也可以直接将 C:\Users\myusername\miniforge3\condabin\ 文件夹 添加到路径环境变量中 手动 这样 conda 和 mamba 就可以在任何命令提示符中更方便地使用，且 发生软件冲突的可能性较低。

在 Unix 上使用非交互式安装时也会出现同样的情况。 初始化可以通过使用完整路径调用 conda 来完成，例如

~/miniforge3/bin/conda init

环境的自动激活

默认情况下，一旦 conda 已为你的 shell 完成初始化，base 环境将被 激活，使得命令 python 对应于 Miniforge 提供的基础 Python，而 conda install 会在 base 环境中安装包。这虽然 可能很方便，但使用以下命令禁用此自动激活功能更为整洁

conda config --set auto_activate_base false

并使用 conda 或 mamba 创建并激活其他环境，例如 （创建一个名为 my_project 的环境）

conda create --name my_project jupyterlab numpy pandas
conda activate my_project
# Now you can start jupyter lab
jupyter lab

最后，您还可以将激活命令添加到您的 shell 配置文件中 （在 Unix 上通常是 ~/.bashrc 或 ~/.zshrc； 在 Windows 上，使用 notepad $PROFILE 进行编辑）。

要求和安装程序

包含 Python 3.13 (*) 的最新安装程序位于基础环境中：

OSArchitectureMinimum VersionFile
Linuxx86_64 (amd64)glibc >= 2.17Miniforge3-Linux-x86_64.sh
Linuxaarch64 (arm64) (**)glibc >= 2.17Miniforge3-Linux-aarch64.sh
Linuxppc64le (POWER8/9)glibc >= 2.17Miniforge3-Linux-ppc64le.sh
macOSx86_64macOS >= 11.0Miniforge3-MacOSX-x86_64.{sh,pkg}
macOSarm64 (Apple Silicon) (***)macOS >= 11.0Miniforge3-MacOSX-arm64.{sh,pkg}
Windowsx86_64 (****)Windows >= 10Miniforge3-Windows-x86_64.exe

(*) Python 版本仅针对基础环境。Conda 可以创建具有不同 Python 版本和实现的新环境。

(**) 对于包含 64 位处理器的 Raspberry PI，您还必须使用 64 位操作系统，例如 Raspberry Pi OS 64-bit 或 Ubuntu for Raspberry PI。 标记为“System: 32-bit”的版本与此网站上的安装程序不兼容。

(***) Apple silicon 构建版本是实验性的，并且没有像其他平台那样经过测试。

(****) Windows 安装程序要求 Windows 10 或更高版本。然而，我们不确定具体是 Windows 10 的哪个版本。 我们需要来自用户的帮助](https://github.com/conda-forge/miniforge/issues/599)来维护 Windows 相关问题的积压列表。

安装

Windows

我们需要来自激活用户和愿意维护者的帮助](https://github.com/conda-forge/miniforge/issues/599)！

下载并执行 Windows 安装程序。 按照提示操作，并注意 “创建开始菜单快捷方式”选项。 使用已安装软件（例如命令 conda 和 mamba） 最方便且经过测试的方式是通过安装到开始菜单的“Miniforge Prompt”。

如果您需要 conda 可被其他软件访问， 您可以考虑选择“将 Miniforge3 添加到我的 PATH 环境变量”选项。 由于可能存在与其他软件的严重冲突，后者默认未选中。参见 https://github.com/conda-forge/miniforge/issues/520 和 https://github.com/conda-forge/miniforge/issues/453。

在安装位置中使用特殊字符和空格存在已知问题，例如参见 https://github.com/conda-forge/miniforge/issues/484 和 https://github.com/conda-forge/miniforge/issues/593。 我们建议用户安装在不包含此类字符的目录中。

对于非交互式使用，可以使用批量安装选项1：

start /wait "" Miniforge3-Windows-x86_64.exe /InstallationType=JustMe /RegisterPython=0 /S /D=%UserProfile%\Miniforge3

Windows Subsystem for Linux (WSL)

Windows Subsystem for Linux (WSL) 允许开发者在 Windows 机器上同时使用 Windows 和 Linux。 WSL 用户应确保他们处于 Linux 终端窗口（而非 Powershell）中，并按照下一节说明中描述的计算机架构使用相应的 Linux 安装程序。

Unix-like platforms (macOS, Linux, & WSL)

在终端窗口中，使用 curl 或 wget 或您喜欢的程序下载适合您计算机架构的安装程序。

例如：

curl -L -O "https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-$(uname)-$(uname -m).sh"

或

wget "https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-$(uname)-$(uname -m).sh"

使用以下命令运行脚本：

bash Miniforge3-$(uname)-$(uname -m).sh

交互式安装会提示您使用 shell 初始化 conda。 这通常是推荐的工作流程。

对于非交互式安装（例如在 CI 上），可以使用以下命令 （调用 -h 以列出额外选项）：

bash Miniforge3-$(uname)-$(uname -m).sh -b

在非交互式安装中，conda 初始化命令默认不会执行。

请注意，Miniforge 已被其他包管理器（如 Homebrew(https://formulae.brew.sh/cask/miniforge)）重新打包。 然而，这可能会导致许多我们未进行测试的兼容性问题。因此，我们不建议使用 Homebrew 来安装 Miniforge。

macOS (PKG 安装程序)

自 2026 年起，macOS 已提供 PKG 安装程序。它们使用 NumFOCUS 证书进行了签名和公证。 下载并执行 Apple Silicon 的 PKG 安装程序。 或 Intel， 并按照屏幕上的步骤，点击“继续”进行操作。

在第四个界面，您可以通过点击“更改安装位置”来选择不同的安装路径。 “自定义”按钮后可能还有其他选项。重要的是，您可以选择让安装程序 为您的 shell 执行 conda 初始化。

准备就绪后，点击“安装”。如果一切按计划进行，摘要页面将报告成功。

对于无人值守安装，请使用上述部分中提到的 SH 安装程序。

作为 CI 流水线的一部分

如果您希望通过命令行以更自动化的方式下载相应的安装程序， 您可能希望使用类似于以下命令

对于 Linux，任何架构，请使用以下命令

wget -O Miniforge3.sh "https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-$(uname)-$(uname -m).sh"

对于 macOS，任意架构，请使用以下命令

curl -fsSLo Miniforge3.sh "https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-MacOSX-$(uname -m).sh"

这将下载适用于当前架构的安装程序，文件名为 Miniforge3.sh。使用带有 -b 标志的命令以批处理模式运行该 shell 脚本：

bash Miniforge3.sh -b -p "${HOME}/conda"

-p 是前缀选项。将在 "${HOME}/conda" 上创建一个目录。

然后，您应该创建到 conda 的路径并激活 conda。 运行此命令：

source "${HOME}/conda/etc/profile.d/conda.sh"
# For mamba support also run the following command
source "${HOME}/conda/etc/profile.d/mamba.sh"

最后，你可以运行命令来激活基础环境

conda activate

卸载

Unix 类平台（macOS 和 Linux）

卸载 Miniforge 意味着删除安装过程中创建的文件。 您通常希望删除以下内容：

  1. Miniforge 对您的 shell rc 文件所做的任何修改：
# Use this first command to see what rc files will be updated
conda init --reverse --dry-run
# Use this next command to take action on the rc files listed above
conda init --reverse
# Temporarily IGNORE the shell message
#       'For changes to take effect, close and re-open your current shell.',
# and CLOSE THE SHELL ONLY AFTER the 3rd step below is completed.
  1. 删除安装 Miniforge 基础环境的文件夹及其所有子文件夹：
CONDA_BASE_ENVIRONMENT="$(conda info --base)"
echo The next command will delete all files in "${CONDA_BASE_ENVIRONMENT}"
# Warning, the rm command below is irreversible!
# check the output of the echo command above
# To make sure you are deleting the correct directory
rm -rf "${CONDA_BASE_ENVIRONMENT}"
  1. 任何遗留的全局 conda 配置文件。
echo ${HOME}/.condarc will be removed if it exists
rm -f "${HOME}/.condarc"
echo ${HOME}/.conda and underlying files will be removed if they exist.
rm -fr "${HOME}/.conda"

功能

  • 自动构建安装程序。
  • 自动上传安装程序构建结果。
  • 自动测试安装程序。
  • 与 conda-forge 开发者文档集成。
  • 与 conda-forge 官方网站集成。

测试

在 CI 上构建完成后，安装程序会针对一系列与安装程序架构匹配的发行版进行测试（$ARCH）。例如，当架构为 aarch64 时，构建的安装程序会针对以下系统进行测试：

  • Centos 7
  • Debian Bullseye (11)
  • Debian Bookworm (12)
  • Debian Trixie (13)
  • Ubuntu 18.04 (LTS)
  • Ubuntu 20.04 (LTS)
  • Ubuntu 22.04 (LTS)
  • Ubuntu 24.04 (LTS)

构建 Miniforge 安装程序

安装程序通过 CI 进行构建和上传，但如果您想自行构建 Miniforge 安装程序，方法如下：

使用 Docker

# Configuration
export ARCH=aarch64
export DOCKERIMAGE=condaforge/linux-anvil-aarch64

bash build_miniforge.sh

不使用 Docker (Linux)

# Configuration
export TARGET_PLATFORM=linux-64

bash scripts/build.sh
bash scripts/test.sh

请务必在 build/test.sh 运行后删除安装目录。如果您运行后续测试，将会出现安装错误。

***** Run the installer *****
+ chmod +x build/Miniforge3-25.1.1-2-Linux-x86_64.sh
++ uname
+ [[ Linux == MINGW* ]]
+ [[ Miniforge3 == \M\i\n\i\f\o\r\g\e\3 ]]
+ sh build/Miniforge3-25.1.1-2-Linux-x86_64.sh -b -p /home/user001/miniforge
ERROR: File or directory already exists: '/home/user001/miniforge'
If you want to update an existing installation, use the -u option.

不使用 docker (Windows)

您必须在 Windows 上安装 Git Bash 或其他 MINGW64 shell，才能成功运行此操作。

export TARGET_PLATFORM=win-64

bash scripts/build.sh
bash scripts/test.sh

对旧版操作系统的支持

对 macOS 10.13-10.15 的支持

如果您需要支持 macOS 10.13 至 10.15，您可以下载 miniforge 的 26.1.1-3 版本，下载地址为 https://github.com/conda-forge/miniforge/releases/tag/26.1.1-3

对 macOS 10.9-10.12 的支持

如果你需要支持 macOS 10.9 到 10.12，你可以下载 miniforge 的 24.3.0-0 版本，该版本可在以下地址获取： https://github.com/conda-forge/miniforge/releases/tag/24.3.0-0

对 glibc 2.12-2.16 的支持

如果你需要支持 glibc 2.12 到 2.16，你可以下载 miniforge 的 24.3.0-0 版本，该版本可在以下地址获取： https://github.com/conda-forge/miniforge/releases/tag/24.3.0-0

常见问题

Mambaforge 和 Miniforge 有什么区别？

在 2023 年 8 月发布 Miniforge 23.3.1 之后，Miniforge 和 Mambaforge 基本上是完全相同的。唯一的区别是安装程序名称以及 随之而来的默认安装路径。

在那次发布之前，Miniforge 仅附带 conda，而 Mambaforge 在此基础上 增加了 mamba。由于 Miniconda 从 2023 年 7 月开始附带 conda-libmamba-solver， Miniforge 随后跟进，也在 8 月开始附带它。从那时起， 由于 conda-libmamba-solver 依赖于 libmambapy，Miniforge 和 Mambaforge 之间 唯一的区别就是 mamba Python 包的存在与否。为了 尽量减少意外情况，我们决定也在 Miniforge 中添加 mamba。

今后我应该选择哪一个，以免其中一个被弃用？

截至 2024 年 6 月，Mambaforge 已被弃用，并将于 2025 年 1 月停止维护。 我们建议用户立即切换到 Miniforge3。有关更多详细信息，请 参见上述说明。

发布

要发布 Miniforge 的新版本：

  • 在 GitHub 上创建一个名为 $CONDA_VERSION-$BUILD_NUMBER 的新预发布版本
  • 等待 CI 上传完所有工件
    • 对于每个构建，我们上传 3 个工件
      1. 一个带有版本名称的安装程序
      2. 一个不带版本名称的安装程序
      3. SHA256
    • 对于 OSX，我们还为每种架构提供一个 pkg 安装程序，带有 2 个 OSX 名称。
    • 截至撰写本文时，工件总数为 28 个，加上两个源代码，预计总计 30 个工件。
  • 将预发布版本标记为正式发布

注意：使用预发布版本对于确保最新链接正常工作非常重要。

License

BSD 3-Clause

History

相关对话：

🚨 PyPy 支持已弃用（自 2024 年 8 月起已弃用）🚨

TL;DR: 我们计划在未来几周内从 conda-forge feedstock 配方中移除 PyPy（从而停止为 PyPy 构建新版本的软件包），除非有足够多的兴趣来证明继续维护的努力是合理的。

为了帮助完成这一过渡，最新的安装程序将：

  • 安装程序将在 10 月的每两周拒绝继续
  • 安装程序将在 11 月的每十天拒绝继续
  • 安装程序将在 12 月的每五天拒绝继续
  • 安装程序将在 2025 年及以后拒绝继续

Miniforge-pypy3

以下列出了包含基础环境中 PyPy 3.9 的最新安装程序。 然而，最新的安装程序将在 2025 年停止工作，并且将不再提供。 因此，如果您需要 PyPy3，应将版本固定为 24.7.0。

操作系统架构最低版本Miniforge 版本
Linuxx86_64 (amd64)glibc >= 2.1724.9.2-0
Linuxx86_64 (amd64)glibc >= 2.1224.3.0-0
Linuxaarch64 (arm64)glibc >= 2.1724.9.2-0
Linuxaarch64 (arm64)glibc >= 2.1224.3.0-0
Linuxppc64le (POWER8/9)glibc >= 2.1724.9.2-0
Linuxppc64le (POWER8/9)glibc >= 2.1224.3.0-0
macOSx86_64macOS >= 10.1324.9.2-0
macOSx86_64macOS >= 10.924.3.0-0
Windowsx86_64Windows >= 724.9.2-0
🚨 Mambaforge（Deprecated 自 2024 年 7 月起）🚨

2024 年 7 月更新：

截至 2024 年 7 月，Mambaforge 已弃用。我们建议用户立即切换到 Miniforge3。这些安装程序将在 2025 年 1 月之后从新版本中移除。为了协助迁移，我们将对最新的 Mambaforge 安装程序引入以下 降级措施。版本 24.5.0-1 及以下的安装程序将不会有任何降级措施。24.5.0-1 将包含一条警告消息。 2024.5.0-2 及更高版本的安装程序将遵循以下降级时间表：

  • 安装程序将在十月每两周拒绝继续
  • 安装程序将在十一月每十天拒绝继续
  • 安装程序将在十二月每五天拒绝继续
  • 安装程序将在 2025 年及以后拒绝继续

之前的信息：

随着 Miniforge3-23.3.1-0 的发布， 其中包含了 #277 中的更改，Mambaforge 和 Miniforge3 的软件包和 配置现在完全相同。两者之间 唯一的区别是安装程序名称，以及由此产生的 默认安装目录。

我们建议立即切换到 Miniforge3。这些安装程序将于 2025 年 1 月停止支持。为了协助 CI 用户迁移到 Miniforge3，我们已停止最新的 Mambaforge (24.5+) 安装程序按以下时间表继续

  • 十月每两周一次
  • 十一月每十天一次
  • 十二月每五天一次
  • 2025 年从不

您仍然可以在 24.9.2 版本发布 中找到最新的安装程序。

Footnotes

  1. CLI 参数文档 ↩