Skip to main content
https://img.shields.io/travis/deeplook/mcinstall/master.svg https://img.shields.io/pypi/pyversions/mcinstall.svg https://img.shields.io/pypi/v/mcinstall.svg https://img.shields.io/pypi/status/mcinstall.svg https://img.shields.io/pypi/format/mcinstall.svg https://img.shields.io/pypi/l/mcinstall.svg https://img.shields.io/badge/platform-unix%20|%20win%20|%20osx%20|%20arm-informational.svg https://img.shields.io/badge/likes-Raspberry%20Pi-%23C51A4A?logo=raspberry%20pi https://img.shields.io/lgtm/alerts/g/deeplook/mcinstall.svg?logo=lgtm&logoWidth=18 https://img.shields.io/lgtm/grade/python/g/deeplook/mcinstall.svg?logo=lgtm&logoWidth=18

A script to quickly make/provision a fresh Miniconda installation from scratch.

The goal of this script is to quickly install a fresh Miniconda across different operating systems and use it in a CI/CD context, too. It will download a Miniconda binary based on your operating system, unpack the binary and install it locally. It was tested on MacOS and Linux ok, has decent Windows support and also aims to support ARM6 and ARM7 on the Raspberry Pi via Berryconda (sadly no longer maintained).

This script has no external dependencies, but expects to be run with Python 3.5+, 3.5 only because this is likely still the prevalent Python 3 version on Rasbian.

N.B. This project is often updated online which is why its git history might look strange…

Installation

Very briefly, it’s pip install mcinstall. More details are available in INSTALL.rst.

Sample Usage

If you run it like this:

mcinstall ~/Downloads/mc3

it will run a command like this on macOS (using some defaults and decent system introspection) to create a conda base installation:

bash Miniconda3-latest-MacOSX-x86_64.sh -b -f -p ~/Downloads/mc3

This can be activated then with a command like this:

source ~/Downloads/mc3/bin/activate

Windows Example:

On Windows if you execute this command:

mcinstall %USERPROFILE%\downloads\mc3

it will run a command like this:

start /wait "" Miniconda3-latest-Windows-x86_64.exe /InstallationType=JustMe /RegisterPython=0 /S /D=%USERPROFILE%\downloads\mc3

This conda installation can be activated then with a command like this:

%USERPROFILE%\mc3\condabin\activate

Suggested test:

mcinstall --verbose --pip-dependencies jupyter,torch ~/Downloads/torchy
source ~/Downloads/torchy/bin/activate
python -c "import torch; print('ok')"

Suggested test dependencies files:

$ more ~/Downloads/reqs.txt
asciinema
torch
torchvision

$ more ~/Downloads/env.yml
name: test
channels:
  - conda-forge
dependencies:
  - voila

Sample run (replaced home directory with ~ manually):

$ mcinstall --verbose --pip-dependencies jupyter,torch ~/Downloads/torchy
Making directory ~/Downloads/torchy.
Downloading https://repo.continuum.io/miniconda/Miniconda3-latest-MacOSX-x86_64.sh ...
Copying to ~/Downloads/Miniconda3-latest-MacOSX-x86_64.sh ...
Running command: bash ~/Downloads/Miniconda3-latest-MacOSX-x86_64.sh -b -f -p ~/Downloads/torchy
PREFIX=~/Downloads/torchy
Unpacking payload ...
Collecting package metadata (current_repodata.json): ...working... done
Solving environment: ...working... done

[...]

Preparing transaction: ...working... done
Executing transaction: ...working... done
installation finished.

Running command: ~/Downloads/torchy/bin/pip install jupyter
[...]

Running command: ~/Downloads/torchy/bin/pip install torch
[...]

Run this to start using your fresh Miniconda: "source ~/Downloads/torchy/bin/activate".

Example command to pass index-url for pip:

mcinstall --verbose --pip-dependencies  pypi_pkg_test --pip-index-url https://test.pypi.org/simple/ ~/Downloads/torchy

Example command to pass extra-index-url for pip:

mcinstall --verbose --pip-dependencies  pypi_pkg_test --pip-index-url https://test.pypi.org/simpletest/ --pip-extra-index-url https://test.pypi.org/simple/ ~/Downloads/torchy

Example to pass multiple extra-index-url for pip:

mcinstall --verbose --pip-dependencies  pypi_pkg_test --pip-index-url https://test.pypi.org/simpletest/ --pip-extra-index-url https://test.pypi.org/simpletest1/,https://test.pypi.org/simple/ ~/Downloads/torchy

Sample log file (mcinstall.log):

wget https://repo.continuum.io/miniconda/Miniconda3-latest-MacOSX-x86_64.sh
mv Miniconda3-latest-MacOSX-x86_64.sh ~/Downloads/Miniconda3-latest-MacOSX-x86_64.sh
bash ~/Downloads/Miniconda3-latest-MacOSX-x86_64.sh -b -f -p ~/Downloads/torchy
source ~/Downloads/torchy/bin/activate
~/Downloads/torchy/bin/pip install jupyter
~/Downloads/torchy/bin/pip install torch

Release files for mcinstall 0.3.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mcinstall 0.3.1
File Size Uploaded
mcinstall-0.3.1.tar.gz 6.7 kB Details

Release files / mcinstall-0.3.1.tar.gz

Download URL mcinstall-0.3.1.tar.gz
Size 6.7 kB
Tags Source
SHA-256 checksum
How to use checksums
dbf23494ef15996321b7e0defb4cb900182a18a8118ae2a1ed1507ead5cbef10
BLAKE2b-256 checksum
How to use checksums
6fb1251384c31dea48088b9b5daa7170a9c0d547a1f8cdef2c1d9323ca2c29d2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/46.2.0.post20200511 requests-toolbelt/0.9.1 tqdm/4.46.0 CPython/3.7.6

Release history Release notifications | RSS feed

This release

0.3.1 This release

1 release file

0.3.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page