folkslinux
/
mamba
mirror of https://github.com/mamba-org/mamba.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Improve micromamba installation documentation (#1839)

This commit is contained in:
Pavel Zwerschke 2022-08-05 23:43:25 +02:00 committed by GitHub
parent ffddf33870
commit ea74955b07
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 61 additions and 40 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

38
README.md
View File

@ -101,43 +101,7 @@ With the `--tree` (or `-t`) flag, you can get the same information in a tree.
## micromamba
`micromamba` is a tiny version of the `mamba` package manager.
It is a pure C++ package with a separate command line interface.
It is very tiny, does not need a `base` environment and does not come with a default version of Python.
It is completely statically linked, which allows you to drop it in some place and just execute it.
It can be used to bootstrap environments (as an alternative to miniconda).
Note: Micromamba is currently experimental and it's advised to use micromamba in containers & CI only.
Download and unzip the executable (from the official conda-forge package):
```sh
# Also available for osx-64 and osx-arm64.
curl -Ls https://micro.mamba.pm/api/micromamba/linux-64/latest | tar -xvj bin/micromamba
# For win-64
curl -Ls https://micro.mamba.pm/api/micromamba/win-64/latest | tar -xvj Library/bin/micromamba.exe
```
We can use `./micromamba shell init ... ` to initialize a shell (`.bashrc`) and a new root environment in `~/micromamba`:
```sh
./bin/micromamba shell init -s bash -p ~/micromamba
source ~/.bashrc
```
Now you can activate the base environment and install new packages, or create other environments.
Note: currently the `-c` arguments have to come at the end of the command line.
```sh
micromamba activate
micromamba install python=3.10 jupyter -c conda-forge
# or
micromamba create -p /some/new/prefix xtensor -c conda-forge
micromamba activate /some/new/prefix
```
For more instructions (including OS X) check out https://gist.github.com/wolfv/fe1ea521979973ab1d016d95a589dcde
A guide on how to install `micromamba` can be found in the [official documentation](https://mamba.readthedocs.io/en/latest/installation.html#micromamba).
### Development installation

63
docs/source/installation.rst
View File

@ -40,7 +40,38 @@ To get ``mamba``, just install it *into the base environment* from the ``conda-f
micromamba
==========
``micromamba`` is completely statically linked, which allows you to drop it in some place and just execute it.
``micromamba`` is a tiny version of the ``mamba`` package manager.
It is a pure C++ package with a separate command line interface.
It is very tiny, does not need a ``base`` environment and does not come with a default version of Python.
It is completely statically linked, which allows you to drop it in some place and just execute it.
It can be used to bootstrap environments (as an alternative to miniconda).
Note: ``micromamba`` is currently experimental and it's advised to use it in containers & CI only.
.. _umamba-install-automatic-installation:
Automatic installation
**********************
If you are using macOS or Linux, there is a simple way of installing ``micromamba``.
Simply execute the installation script in your preferred shell.
For Linux, the default shell is ``bash``:
.. code:: bash
curl micro.mamba.pm/install.sh | bash
For macOS, the default shell is ``zsh``:
.. code:: zsh
curl micro.mamba.pm/install.sh | zsh
.. _umamba-install-manual-installation:
Manual installation
*******************
Download and unzip the executable (from the official conda-forge package):
@ -61,6 +92,7 @@ The following magic URL always returns the latest available version of micromamb
.. note::
Additional builds are available for linux-aarch64 (ARM64) and linux-ppc64le. Just modify ``linux-64`` in the URL above to match the desired architecture.
You can find the available builds on `anaconda.org <https://anaconda.org/conda-forge/micromamba/files>`_.
After extraction is completed, we can use the micromamba binary.
@ -91,8 +123,8 @@ Now you can activate the base environment and install new packages, or create ot
micromamba activate # this activates the base environment
micromamba install python=3.6 jupyter -c conda-forge
# or
micromamba create -n new_prefix xtensor -c conda-forge
micromamba activate new_prefix
micromamba create -n env_name xtensor -c conda-forge
micromamba activate env_name
.. _umamba-install-osx:
@ -101,11 +133,26 @@ OS X
``micromamba`` has OS X support as well. Instructions are largely the same as :ref:`linux<umamba-install-linux>`:
You need to download a different `micromamba` binary depending if you are using an Apple Silicon or an Intel Mac.
Apple Silicon:
.. code::
curl -Ls https://micro.mamba.pm/api/micromamba/osx-arm64/latest | tar -xvj bin/micromamba
mv bin/micromamba ./micromamba
Intel:
.. code:: bash
curl -Ls https://micro.mamba.pm/api/micromamba/osx-64/latest | tar -xvj bin/micromamba
mv bin/micromamba ./micromamba
The rest of the installation is the same for both Apple Silicon and Intel.
.. code::
# directly execute the hook
eval "$(./bin/micromamba shell hook -s posix)"
@ -171,3 +218,13 @@ The completion is now available in any new shell opened or in the current shell
.. code::
micromamba activate <TAB><TAB>
.. _umamba-install-api:
API
===
We should soon figure out an automated process to use the latest version of micromamba.
We can use the anaconda api: https://api.anaconda.org/release/conda-forge/micromamba/latest to find all the latest packages,
we just need to select the one for the right platform.