{"id":13444277,"url":"https://github.com/conda-forge/miniforge","last_synced_at":"2026-04-01T18:54:45.027Z","repository":{"id":37276135,"uuid":"221584272","full_name":"conda-forge/miniforge","owner":"conda-forge","description":"A conda-forge distribution.","archived":false,"fork":false,"pushed_at":"2026-03-19T22:24:25.000Z","size":935,"stargazers_count":9471,"open_issues_count":128,"forks_count":485,"subscribers_count":61,"default_branch":"main","last_synced_at":"2026-03-20T13:13:19.933Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://conda-forge.org/download","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/conda-forge.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"numfocus","custom":"https://numfocus.org/donate-to-conda-forge"}},"created_at":"2019-11-14T01:23:03.000Z","updated_at":"2026-03-20T05:31:56.000Z","dependencies_parsed_at":"2024-04-14T21:25:52.330Z","dependency_job_id":"a09fa5fd-77d6-4ded-b1b9-0f0e4bc2a1d1","html_url":"https://github.com/conda-forge/miniforge","commit_stats":{"total_commits":507,"total_committers":44,"mean_commits":"11.522727272727273","dds":0.6646942800788955,"last_synced_commit":"4c2f12c7163007aa206a6605bfd36cae45207b60"},"previous_names":[],"tags_count":112,"template":false,"template_full_name":null,"purl":"pkg:github/conda-forge/miniforge","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/conda-forge%2Fminiforge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/conda-forge%2Fminiforge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/conda-forge%2Fminiforge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/conda-forge%2Fminiforge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/conda-forge","download_url":"https://codeload.github.com/conda-forge/miniforge/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/conda-forge%2Fminiforge/sbom","scorecard":{"id":55490,"data":{"date":"2025-08-11","repo":{"name":"github.com/conda-forge/miniforge","commit":"1f5c4f59398766887883b90177fb6adae88a3fc8"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":4.5,"checks":[{"name":"Code-Review","score":8,"reason":"Found 9/11 approved changesets -- score normalized to 8","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Maintained","score":10,"reason":"11 commit(s) and 5 issue activity found in the last 90 days -- score normalized to 10","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Pinned-Dependencies","score":10,"reason":"all dependencies are pinned","details":["Info:   8 out of   8 GitHub-owned GitHubAction dependencies pinned","Info:   7 out of   7 third-party GitHubAction dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/autoupdate.yml:1","Warn: no topLevel permission defined: .github/workflows/ci.yml:1","Warn: no topLevel permission defined: .github/workflows/conda_release.yml:1","Warn: no topLevel permission defined: .github/workflows/docs.yml:1","Warn: no topLevel permission defined: .github/workflows/lint.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":9,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Warn: project license file does not contain an FSF or OSI license."],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'main'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Signed-Releases","score":0,"reason":"Project has not signed or included provenance with any releases.","details":["Warn: release artifact 25.3.1-0 not signed: https://api.github.com/repos/conda-forge/miniforge/releases/236140277","Warn: release artifact 25.3.0-3 not signed: https://api.github.com/repos/conda-forge/miniforge/releases/217799197","Warn: release artifact 25.3.0-2 not signed: https://api.github.com/repos/conda-forge/miniforge/releases/215200284","Warn: release artifact 25.3.0-1 not signed: https://api.github.com/repos/conda-forge/miniforge/releases/210567834","Warn: release artifact 25.3.0-0 not signed: https://api.github.com/repos/conda-forge/miniforge/releases/210407111","Warn: release artifact 25.3.1-0 does not have provenance: https://api.github.com/repos/conda-forge/miniforge/releases/236140277","Warn: release artifact 25.3.0-3 does not have provenance: https://api.github.com/repos/conda-forge/miniforge/releases/217799197","Warn: release artifact 25.3.0-2 does not have provenance: https://api.github.com/repos/conda-forge/miniforge/releases/215200284","Warn: release artifact 25.3.0-1 does not have provenance: https://api.github.com/repos/conda-forge/miniforge/releases/210567834","Warn: release artifact 25.3.0-0 does not have provenance: https://api.github.com/repos/conda-forge/miniforge/releases/210407111"],"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Vulnerabilities","score":1,"reason":"9 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: PYSEC-2019-217 / GHSA-462w-v97r-4m45","Warn: Project is vulnerable to: PYSEC-2014-8 / GHSA-8r7q-cvjq-x353","Warn: Project is vulnerable to: GHSA-cpwx-vrp4-4pq7","Warn: Project is vulnerable to: PYSEC-2014-82 / GHSA-fqh9-2qgg-h84h","Warn: Project is vulnerable to: PYSEC-2021-66 / GHSA-g3rq-g295-4j3m","Warn: Project is vulnerable to: GHSA-h5c8-rqwp-cp95","Warn: Project is vulnerable to: GHSA-h75v-3vvj-5mfj","Warn: Project is vulnerable to: PYSEC-2019-220 / GHSA-hj2j-77xm-mc5v","Warn: Project is vulnerable to: GHSA-q2x7-8rv6-6q7h"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 30 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-15T00:38:55.954Z","repository_id":37276135,"created_at":"2025-08-15T00:38:55.954Z","updated_at":"2025-08-15T00:38:55.954Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31290977,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T13:12:26.723Z","status":"ssl_error","status_checked_at":"2026-04-01T13:12:25.102Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-07-31T03:02:23.527Z","updated_at":"2026-04-01T18:54:45.017Z","avatar_url":"https://github.com/conda-forge.png","language":"Shell","funding_links":["https://github.com/sponsors/numfocus","https://numfocus.org/donate-to-conda-forge"],"categories":["Shell","Programming","others","HarmonyOS"],"sub_categories":["Python","Windows Manager"],"readme":"# Miniforge\n\n[![Build miniforge](https://github.com/conda-forge/miniforge/actions/workflows/ci.yml/badge.svg)](https://github.com/conda-forge/miniforge/actions/workflows/ci.yml)\n[![GitHub downloads](https://img.shields.io/github/downloads/conda-forge/miniforge/total.svg)](https://tooomm.github.io/github-release-stats/?username=conda-forge\u0026repository=miniforge)\n\nThis repository holds the minimal installers for [Conda](https://conda.io/) and [Mamba](https://github.com/mamba-org/mamba) specific to [conda-forge](https://conda-forge.org/), with the following features pre-configured:\n\n* Packages in the base environment are obtained from the [conda-forge channel](https://anaconda.org/conda-forge).\n* The [conda-forge](https://conda-forge.org/) channel is set as the default (and only) channel.\n\nWe put an emphasis on supporting various CPU architectures (x86_64, ppc64le,\nand aarch64 including Apple Silicon) as well as the stability of this\ninstaller.\n\n## Goals\n\nThe goal of this installer is to provide you with an entry point to the\nconda and mamba commands. If these two commands execute correctly, then this\ninstaller has achieved its goal.\n\nIf you have issues with specific packages, please report them to the\nassociated feedstock. You may find the feedstock associated with a package using\nour [website](https://conda-forge.org/packages/)\n\n## Usage\n\nMiniforge provides installers for the commands [`conda`](https://conda.io/) and\n[`mamba`](https://github.com/mamba-org/mamba).  Once the installer for your OS\nand architecture has been executed, you should be able to use these commands in\na terminal.\n\n### conda/mamba usable in any terminals\n\nHowever, with the default choices of the Windows installer, these commands are\nonly available in the \"Miniforge Prompt\". To be able to use these commands in\nother terminals, one needs to initialize conda for your shell by running in\nthe Miniforge Prompt.\n\n```sh\nconda init\n```\n\nNote that one can also just add the `C:\\Users\\myusername\\miniforge3\\condabin\\` folder\nto the path environment variable\n[manually](https://learn.microsoft.com/en-us/previous-versions/office/developer/sharepoint-2010/ee537574(v=office.14)#to-add-a-path-to-the-path-environment-variable)\nso `conda` and `mamba` may be used more conveniently from any command prompt with limited\nchance of software conflicts.\n\nThe same situation arises on Unix if you use the non-interactive install.\nInitialization can be done by calling conda with its full path, with something like\n\n```sh\n~/miniforge3/bin/conda init\n```\n\n### Automatic activation of environments\n\nBy default, once conda has been initialized for your shell, the `base` environment is\nactivated so that the command `python` corresponds to the base Python provided by\nMiniforge and `conda install` installs packages in the `base` environment. This can\nbe convenient for but it is cleaner to deactivate this automatic activation with\n\n```sh\nconda config --set auto_activate_base false\n```\n\nand use `conda` or `mamba` to create and activate other environments, with for example\n(to create an environment called `my_project`)\n\n```sh\nconda create --name my_project jupyterlab numpy pandas\nconda activate my_project\n# Now you can start jupyter lab\njupyter lab\n```\n\nFinally, it is also possible to add to your shell configuration file\n(typically `~/.bashrc` or `~/.zshrc` on Unix;\non Windows, edit with `notepad $PROFILE`) the activation command.\n\n## Requirements and installers\n\nLatest installers with Python 3.12 `(*)` in the base environment:\n\n| OS      | Architecture                  | Minimum Version | File                                |\n| ------- | ----------------------------- | --------------- | ----------------------------------- |\n| Linux   | x86_64 (amd64)                | glibc \u003e= 2.17   | `Miniforge3-Linux-x86_64.sh`        |\n| Linux   | aarch64 (arm64) `(**)`        | glibc \u003e= 2.17   | `Miniforge3-Linux-aarch64.sh`       |\n| Linux   | ppc64le (POWER8/9)            | glibc \u003e= 2.17   | `Miniforge3-Linux-ppc64le.sh`       |\n| macOS   | x86_64                        | macOS \u003e= 10.13  | `Miniforge3-MacOSX-x86_64.{sh,pkg}` |\n| macOS   | arm64 (Apple Silicon) `(***)` | macOS \u003e= 11.0   | `Miniforge3-MacOSX-arm64.{sh,pkg}`  |\n| Windows | x86_64 `(****)`               | Windows \u003e= 10   | `Miniforge3-Windows-x86_64.exe`     |\n\n`(*)` The Python version is specific only to the base environment. Conda can create new environments with different Python versions and implementations.\n\n`(**)` For Raspberry PI that include a 64 bit processor, you must also use\na 64-bit operating system such as\n[Raspberry Pi OS 64-bit](https://www.raspberrypi.com/software/operating-systems/#raspberry-pi-os-64-bit)\nor\n[Ubuntu for Raspberry PI](https://ubuntu.com/raspberry-pi).\nThe versions listed as \"System: 32-bit\" are not compatible with the installers on this website.\n\n`(***)` Apple silicon builds are experimental and haven't had testing like the other platforms.\n\n`(****)` The Windows installer requires Windows 10 or later. However, we are unsure exactly what version of Windows 10.\nWe need [help](https://github.com/conda-forge/miniforge/issues/599) from users to maintain the backlog of windows questions.\n\n## Install\n\n### Windows\n\nWe [need help](https://github.com/conda-forge/miniforge/issues/599) from activate users and willing maintainers!\n\nDownload and execute [the Windows installer](https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-Windows-x86_64.exe).\nFollow the prompts, taking note of the option to\n\"Create start menu shortcuts\".\nThe most convenient and tested way to use the installed software\n(such as commands `conda` and `mamba`)\nis via the \"Miniforge Prompt\" installed to the start menu.\n\nIf you require conda to be accessible to other software,\nyou may consider the option to \"Add Miniforge3 to my PATH environment variable\".\nThe latter is not selected by default due to the potential of serious conflicts\nwith other software. See https://github.com/conda-forge/miniforge/issues/520 and\nhttps://github.com/conda-forge/miniforge/issues/453.\n\nThere are known issues with the usage of special characters and spaces in\nthe installation location, see for example\nhttps://github.com/conda-forge/miniforge/issues/484 and\nhttps://github.com/conda-forge/miniforge/issues/593.\nWe recommend users install in a directory without any such characters in the name.\n\nFor non-interactive usage one can use the batch install option:\n\n```sh\nstart /wait \"\" Miniforge3-Windows-x86_64.exe /InstallationType=JustMe /RegisterPython=0 /S /D=%UserProfile%\\Miniforge3\n```\n### Windows Subsystem for Linux (WSL)\nThe Windows Subsystem for Linux (WSL) lets developers use both Windows and Linux at the same time on a Windows machine.\nWSL users should make sure they are in a Linux terminal window (not Powershell) and use the Linux installer appropriate for the computer's architecture as described in the instructions in the next section.\n\n### Unix-like platforms (macOS, Linux, \u0026 WSL)\nFrom a terminal window, download the installer appropriate for your computer's architecture using curl or wget or your favorite program.\n\nFor example:\n\n```sh\ncurl -L -O \"https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-$(uname)-$(uname -m).sh\"\n```\n\nor\n\n```sh\nwget \"https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-$(uname)-$(uname -m).sh\"\n```\n\nRun the script with:\n\n```sh\nbash Miniforge3-$(uname)-$(uname -m).sh\n```\n\nThe interactive installation will prompt you to initialize conda with your shell.\nThis is typically with recommended workflow.\n\nFor non-interactive install (for example on a CI), the following command can be used\n(call with `-h` to list the extra options):\n\n```sh\nbash Miniforge3-$(uname)-$(uname -m).sh -b\n```\n\nIn non-interactive installations, the conda initialization commands will not be run by default.\n\n\nNote that Miniforge has been repacked by other package managers such as [Homebrew](https://brew.sh/)(https://formulae.brew.sh/cask/miniforge).\nHowever this can lead to many incompatibilities that we do not test for. As such, we do not recommend using Homebrew to install Miniforge.\n\n### macOS (PKG installers)\n\nPKG installers are available for macOS as of 2026. They are signed and notarized with NumFOCUS certificates.\nDownload and execute [the PKG installer for Apple Silicon](https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-MacOSX-arm64.pkg).\nor [Intel](https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-MacOSX-x86_64.pkg),\nand follow the steps on screen by pressing Continue.\n\nBy the 4th screen, you can choose a different installation path by clicking on \"Change Install Location\".\nOther options may be available behind the \"Customise\" button.\n\nOnce ready, click on Install. If everything went according to plan, the Summary page will report success.\n\nFor unattended installs, please use the SH installers mentioned in the section above.\n\n### As part of a CI pipeline\n\nIf you wish to download the appropriate installer through the command line in a\nmore automated fashion, you may wish to a command similar to\n\nFor Linux, any architecture, use the following command\n\n```sh\nwget -O Miniforge3.sh \"https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-$(uname)-$(uname -m).sh\"\n```\n\nFor macOS, any architecture, use the following command\n\n```sh\ncurl -fsSLo Miniforge3.sh \"https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-MacOSX-$(uname -m).sh\"\n```\n\nThis will download the appropriate installer for the present architecture with\nthe filename `Miniforge3.sh`. Run the shell script with the command in batch\nmode with the `-b` flag:\n\n```sh\nbash Miniforge3.sh -b -p \"${HOME}/conda\"\n```\n\n`-p` is prefix option. A directory will be created on `\"${HOME}/conda\"`.\n\nThen you should create the path to conda and activate conda.\nRun this command:\n\n```sh\nsource \"${HOME}/conda/etc/profile.d/conda.sh\"\n# For mamba support also run the following command\nsource \"${HOME}/conda/etc/profile.d/mamba.sh\"\n```\n\nFinally, you can run the command to activate the base environment\n\n```sh\nconda activate\n```\n\n\n## Uninstall\n\n### Unix-like platforms (macOS \u0026 Linux)\n\nUninstalling Miniforge means removing the files that were created during the installation process.\nYou will typically want to remove:\n\n1. Any modifications to your shell rc files that were made by Miniforge:\n\n```sh\n# Use this first command to see what rc files will be updated\nconda init --reverse --dry-run\n# Use this next command to take action on the rc files listed above\nconda init --reverse\n# Temporarily IGNORE the shell message\n#       'For changes to take effect, close and re-open your current shell.',\n# and CLOSE THE SHELL ONLY AFTER the 3rd step below is completed.\n```\n\n2. Remove the folder and all subfolders where the base environment for Miniforge was installed:\n\n```sh\nCONDA_BASE_ENVIRONMENT=\"$(conda info --base)\"\necho The next command will delete all files in \"${CONDA_BASE_ENVIRONMENT}\"\n# Warning, the rm command below is irreversible!\n# check the output of the echo command above\n# To make sure you are deleting the correct directory\nrm -rf \"${CONDA_BASE_ENVIRONMENT}\"\n```\n\n3. Any global conda configuration files that are left behind.\n\n```sh\necho ${HOME}/.condarc will be removed if it exists\nrm -f \"${HOME}/.condarc\"\necho ${HOME}/.conda and underlying files will be removed if they exist.\nrm -fr \"${HOME}/.conda\"\n```\n\n\n## Features\n\n- [X] Automatic build of constructor.\n- [X] Automatic upload of constructor results.\n- [X] Automatic testing of constructor.\n- [ ] Integration with conda-forge's developer documentation.\n- [x] Integration with conda-forge's official site.\n\n\n## Testing\n\nAfter construction on the CI, the installer is tested against a range of distribution that match the installer architecture (`$ARCH`). For example when architecture is `aarch64`, the constructed installer is tested against:\n\n- Centos 7\n- Debian Bullseye (11)\n- Debian Bookworm (12)\n- Debian Trixie (13)\n- Ubuntu 18.04 ([LTS](https://ubuntu.com/about/release-cycle))\n- Ubuntu 20.04 ([LTS](https://ubuntu.com/about/release-cycle))\n- Ubuntu 22.04 ([LTS](https://ubuntu.com/about/release-cycle))\n- Ubuntu 24.04 ([LTS](https://ubuntu.com/about/release-cycle))\n\n## Building a Miniforge Installer\n\nInstallers are built and uploaded via the CI but if you want to construct your own Miniforge installer, here is how:\n\n### With Docker\n```sh\n# Configuration\nexport ARCH=aarch64\nexport DOCKERIMAGE=condaforge/linux-anvil-aarch64\n\nbash build_miniforge.sh\n```\n\n### Without Docker (Linux)\n```sh\n# Configuration\nexport TARGET_PLATFORM=linux-64\n\nbash scripts/build.sh\nbash scripts/test.sh\n```\n_Be sure to delete the installation directory after `build/test.sh` has run. You will get installation errors if you run subsequent tests._\n```\n***** Run the installer *****\n+ chmod +x build/Miniforge3-25.1.1-2-Linux-x86_64.sh\n++ uname\n+ [[ Linux == MINGW* ]]\n+ [[ Miniforge3 == \\M\\i\\n\\i\\f\\o\\r\\g\\e\\3 ]]\n+ sh build/Miniforge3-25.1.1-2-Linux-x86_64.sh -b -p /home/user001/miniforge\nERROR: File or directory already exists: '/home/user001/miniforge'\nIf you want to update an existing installation, use the -u option.\n```\n\n### Without docker (Windows)\nYou must have Git Bash, or some other MINGW64 shell installed on Windows for this to run successfully.\n```sh\nexport TARGET_PLATFORM=win-64\n\nbash scripts/build.sh\nbash scripts/test.sh\n```\n\n## Support for older operating systems\n\n### Support for macOS 10.9-10.12\n\nIf you require support for macOS 10.9 through 10.12 you may download version\n24.3.0-0 of miniforge available at\nhttps://github.com/conda-forge/miniforge/releases/tag/24.3.0-0\n\n### Support for glibc 2.12-2.16\n\nIf you require support for glibc 2.12 through 2.16 you may download version\n24.3.0-0 of miniforge available at\nhttps://github.com/conda-forge/miniforge/releases/tag/24.3.0-0\n\n\n## FAQ\n\n### What's the difference between Mambaforge and Miniforge?\n\nAfter the release of Miniforge 23.3.1 in August 2023, Miniforge and Mambaforge\nare essentially identical. The only difference is the name of the installer and\nsubsequently the default installation path.\n\nBefore that release, Miniforge only shipped conda, while Mambaforge added mamba\non top. Since Miniconda started shipping conda-libmamba-solver in July 2023,\nMiniforge followed suit and started shipping it too in August. At that point,\nsince conda-libmamba-solver depends on libmambapy, the only difference between\nMiniforge and Mambaforge was the presence of the mamba Python package. To\nminimize surprises, we decided to add mamba to Miniforge too.\n\n### Should I choose one or another going forward at the risk of one of them getting deprecated?\n\nAs of June 2024, Mambaforge is deprecated and will be retired in January 2025.\nWe recommend users switch to Miniforge3 immediately. For more details, please\nsee the note above.\n\n\n## Release\n\nTo release a new version of Miniforge:\n\n- Make a new pre-release on GitHub with name `$CONDA_VERSION-$BUILD_NUMBER`\n- Wait until all artifacts are uploaded by CI\n  - For each build, we upload 3 artifacts\n    1. One installer with the version name\n    2. One installer without the version name\n    3. The SHA256\n  - For OSX we also have one pkg installer for each architecture, with the 2 OSX names.\n  - At the time of writing, the is a sum of 28 artifacts, and with the two sources, we expect a grand total of 30 artifacts.\n- Mark the pre-release as a release\n\nNOTE: using a pre-release is important to make sure the latest links work.\n\n\n## License\n\n[BSD 3-Clause](./LICENSE)\n\n\n## History\n\nRelevant conversations:\n\n- https://github.com/conda-forge/conda-forge.github.io/issues/871#issue-496677528\n- https://github.com/conda-forge/conda-forge.github.io/pull/922\n\n\n\u003cdetails\u003e\n\n\u003csummary\u003e🚨 PyPy support is deprecated (\u003cb\u003eDeprecated\u003c/b\u003e as of August 2024) 🚨\u003c/summary\u003e\n\nTL;DR: We are planning to remove PyPy from conda-forge feedstock recipes in a\nfew weeks (and thus to stop building new releases of packages for PyPy), unless\nthere is substantial enough interest to justify the continued maintenance\neffort.\n\nTo help with this transition, the latest installers will:\n\n* The installer will refuse to proceed every two weeks in October\n* The installer will refuse to proceed every ten days in November\n* The installer will refuse to proceed every five days in December\n* The installer will refuse to proceed in 2025+\n\n### Miniforge-pypy3\n\nLatest installers with PyPy 3.9 in the base environment are listed below.\nHowever, the latest installers will cease to work and will stop being made available in 2025.\nYou should therefore pin to 24.7.0 if you require PyPy3.\n\n| OS      | Architecture       | Minimum Version | Miniforge Version                                                          |\n| ------- | ------------------ | --------------- | -------------------------------------------------------------------------- |\n| Linux   | x86_64 (amd64)     | glibc \u003e= 2.17   | [24.9.2-0](https://github.com/conda-forge/miniforge/releases/tag/24.9.2-0) |\n| Linux   | x86_64 (amd64)     | glibc \u003e= 2.12   | [24.3.0-0](https://github.com/conda-forge/miniforge/releases/tag/24.3.0-0) |\n| Linux   | aarch64 (arm64)    | glibc \u003e= 2.17   | [24.9.2-0](https://github.com/conda-forge/miniforge/releases/tag/24.9.2-0) |\n| Linux   | aarch64 (arm64)    | glibc \u003e= 2.12   | [24.3.0-0](https://github.com/conda-forge/miniforge/releases/tag/24.3.0-0) |\n| Linux   | ppc64le (POWER8/9) | glibc \u003e= 2.17   | [24.9.2-0](https://github.com/conda-forge/miniforge/releases/tag/24.9.2-0) |\n| Linux   | ppc64le (POWER8/9) | glibc \u003e= 2.12   | [24.3.0-0](https://github.com/conda-forge/miniforge/releases/tag/24.3.0-0) |\n| macOS   | x86_64             | macOS \u003e= 10.13  | [24.9.2-0](https://github.com/conda-forge/miniforge/releases/tag/24.9.2-0) |\n| macOS   | x86_64             | macOS \u003e= 10.9   | [24.3.0-0](https://github.com/conda-forge/miniforge/releases/tag/24.3.0-0) |\n| Windows | x86_64             | Windows \u003e= 7    | [24.9.2-0](https://github.com/conda-forge/miniforge/releases/tag/24.9.2-0) |\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\n\u003csummary\u003e🚨 Mambaforge (\u003cb\u003eDeprecated\u003c/b\u003e as of July 2024) 🚨\u003c/summary\u003e\n\nUpdate for July 2024:\n\nAs of July 2024, `Mambaforge` is deprecated. We suggest users switch to\n`Miniforge3` immediately. These installers will be retired from new releases\nafter January 2025. To assist in the migration, we will be introducing rollowing\nbrownouts to the latest Mambaforge installer. Installers up to version 24.5.0-1\nwill not have any brownouts. 24.5.0-1 will include a warning message.\nInstallers 2024.5.0-2 and later will have the following brownout schedule:\n\n* The installer will refuse to proceed every two weeks in October\n* The installer will refuse to proceed every ten days in November\n* The installer will refuse to proceed every five days in December\n* The installer will refuse to proceed in 2025+\n\nPrevious information:\n\nWith the [release](https://github.com/conda-forge/miniforge/releases/tag/23.3.1-0) of\n`Miniforge3-23.3.1-0`, that incorporated the changes in\n[#277](https://github.com/conda-forge/miniforge/pull/277), the packages and\nconfiguration of `Mambaforge` and `Miniforge3` are now **identical**. The\nonly difference between the two is the name of the installer and, subsequently,\nthe default installation directory.\n\nWe recommend switching to `Miniforge3` immediately. These installers will be\nretired in January 2025. To assist in the migration to Miniforge3 for CI users, we've stopped\nthe latest Mambaforge (24.5+) installer from proceeding with following schedule\n\n* Every two weeks in October\n* Every ten days in November\n* Every five days in December\n* Never in 2025\n\nYou can still find the latest installers in the [24.9.2 release](https://github.com/conda-forge/miniforge/releases/tag/24.9.2-0).\n\n\u003c/details\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fconda-forge%2Fminiforge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fconda-forge%2Fminiforge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fconda-forge%2Fminiforge/lists"}