Skip to content

Update installation.md #2020

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
MMathisLab merged 3 commits into from
Oct 29, 2022
Merged

Update installation.md #2020

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
587830c
Update installation.md
MMathisLab Oct 21, 2022
8653656
Update installTips.md
MMathisLab Oct 21, 2022
11df9f2
Update installation.md
MMathisLab Oct 21, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/installation.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
(how-to-install)=
# How To Install DeepLabCut

DeepLabCut can be run on Windows, Linux, or MacOS (see also [technical considerations](tech-considerations-during-install) and if you run into issues also check out [installation ProTips](installTips)).
DeepLabCut can be run on Windows, Linux, or MacOS (see also [technical considerations](tech-considerations-during-install) and if you run into issues also check out the [Installation Tips](https://deeplabcut.github.io/DeepLabCut/docs/recipes/installTips.html) page).

## PIP:

Expand Down
49 changes: 34 additions & 15 deletions docs/recipes/installTips.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -313,37 +313,56 @@ Activate! `conda activate DEEPLABCUT` and then run: `conda install -c conda-forg
Then run `python -m deeplabcut` which launches the DLC GUI.


## DeepLabCut M1 chip installation environment instructions:
## DeepLabCut MacOS M1 and M2 chip installation environment instructions:

This only assumes you have anaconda installed!
This only assumes you have anaconda installed.

Use the `DEEPLABCUT_M1.yaml` conda file if you have an Macbok with an M1 chip, and follow these steps:
Use the `DEEPLABCUT_M1.yaml` conda file if you have an Macbok with an M1 or M2 chip, and follow these steps:

(1) git clone the deeplabcut cut repo:

`git clone https://github.com/DeepLabCut/DeepLabCut.git`

(2) in the program terminal, `cd DeepLabCut/conda-environments`
```
git clone https://github.com/DeepLabCut/DeepLabCut.git
```

(3) Click here to download the Rosetta wheel for TensorFlow.
(2) in the program terminal run: `cd DeepLabCut/conda-environments`

For instance, for 2.4.1:
https://drive.google.com/file/d/17pSwfoNuyf3YR8vCaVggHeI-pMQ3xL7l/view?usp=sharing
(for different versions see here: https://github.com/tensorflow/tensorflow/issues/46044)
(3) Click [here](https://drive.google.com/file/d/17pSwfoNuyf3YR8vCaVggHeI-pMQ3xL7l/view?usp=sharing) to download the Rosetta wheel for TensorFlow. We assume this goes into your Downloads folder. This downloads TF 2.4.1; https://drive.google.com/file/d/17pSwfoNuyf3YR8vCaVggHeI-pMQ3xL7l/view?usp=sharing
(for different versions see here: https://github.com/tensorflow/tensorflow/issues/46044).

(4) Then, run:

`conda env create -f DEEPLABCUT_M1.yaml`
```
conda env create -f DEEPLABCUT_M1.yaml
```

(5) Please activate the environment and set osx-64; i.e., then, run:

```
conda activate DEEPLABCUT_M1
conda env config vars set CONDA_SUBDIR=osx-64
```
Now, as the print satement says, please deactivate and re-activate to set the change:

```
conda deactivate
conda activate DEEPLABCUT_M1
conda env update -f DEEPLABCUT_M1.yaml
```

(5) Next, run:

(5) Next, **activate the environment,** and in the terminal `cd` to Downloads, and then run:
```
pip install ~/Downloads/tensorflow-2.4.1-py3-none-any.whl --no-dependencies --force-reinstall
```
(again, assumes this file in your downloads folder)

`pip install tensorflow-2.4.1-py3-none-any.whl --no-dependencies --force-reinstall`

(6) Next, launch DLC with `pythonw -m deeplabcut`
(6) Next, launch DLC with `pythonw -m deeplabcut` (or if DLC version 2.3+, please use `python -m deeplabcut`)

GUI will open!

Note: Based on issue #1380 thanks!
Note: Based on issues #1380 and #2011, thanks!

## How to confirm that your GPU is being used by DeepLabCut

Expand Down