|
[<img src="uploads/b78708ab8609c803fced7b5c6c86096f/00-fidle-header-03.svg">](home)
|
|
|
|
|
|
|
|
|
|
|
|
**- Notes -**
|
|
**- Notes -**
|
|
- This installation procedure is based on the official Tensorflow and PyTorch procedure, <br>which are described here :
|
|
|
|
<https://www.tensorflow.org/install/pip> and <https://pytorch.org/>
|
|
- This installation procedure is based on the official Tensorflow and PyTorch procedure, \
|
|
- If you have a **GPU card**, things can be more complicated than this simplified procedure. <br>We advise you to consult the documentation mentioned above.
|
|
which are described here : https://www.tensorflow.org/install/pip and https://pytorch.org/
|
|
|
|
- If you have a **GPU card**, things can be more complicated than this simplified procedure. \
|
|
|
|
We advise you to consult the documentation mentioned above.
|
|
- All commands presented below and prefixed by `$` are to be launched on a terminal/unix console.
|
|
- All commands presented below and prefixed by `$` are to be launched on a terminal/unix console.
|
|
- `(fidle-env) $` is the fidle-env python prompt
|
|
- `(fidle-env) $` is the fidle-env python prompt
|
|
- Size a full installation (environment, data, notebooks) is **around 8GB**
|
|
- Size a full installation (environment, data, notebooks) is **around 8GB**
|
... | @@ -20,24 +20,27 @@ |
... | @@ -20,24 +20,27 @@ |
|
A version of **python 3.6 to 3.9** is required.
|
|
A version of **python 3.6 to 3.9** is required.
|
|
|
|
|
|
**Note :**
|
|
**Note :**
|
|
|
|
|
|
- **Do not download the latest version 3.11 !**
|
|
- **Do not download the latest version 3.11 !**
|
|
|
|
|
|
For example, if you are root (administrator in your Linux system) under Debian :
|
|
For example, if you are root (administrator in your Linux system) under Debian :
|
|
|
|
|
|
```
|
|
```plaintext
|
|
sudo apt-get install python3 python3-dev python3-pip python3-venv
|
|
sudo apt-get install python3 python3-dev python3-pip python3-venv
|
|
```
|
|
```
|
|
|
|
|
|
## 2 - A folder to contain them all
|
|
## 2 - A folder to contain them all
|
|
|
|
|
|
The idea is to put everything in the same folder, for example `fidle-tp`
|
|
The idea is to put everything in the same folder, for example `fidle-tp`
|
|
|
|
|
|
```
|
|
```plaintext
|
|
$ mkdir ~/fidle-tp
|
|
$ mkdir ~/fidle-tp
|
|
$ cd ~/fidle-tp
|
|
$ cd ~/fidle-tp
|
|
```
|
|
```
|
|
|
|
|
|
## 3 - A python environment, just for us !
|
|
## 3 - A python environment, just for us !
|
|
|
|
|
|
The idea is to create a virtual python environment, in order not to "pollute" your system.
|
|
The idea is to create a virtual python environment, in order not to "pollute" your system.\
|
|
This virtual environment will be contained in a sub folder (fidle-env).
|
|
This virtual environment will be contained in a sub folder (fidle-env).
|
|
|
|
|
|
To create a virtual environment "fidle-env" and activate it:
|
|
To create a virtual environment "fidle-env" and activate it:
|
... | @@ -50,24 +53,48 @@ $ source ./fidle-env/bin/activate |
... | @@ -50,24 +53,48 @@ $ source ./fidle-env/bin/activate |
|
We can now install all the necessary modules in our python environment :
|
|
We can now install all the necessary modules in our python environment :
|
|
|
|
|
|
```plaintext
|
|
```plaintext
|
|
(fidle-env) $ pip install --upgrade tensorflow==2.12 torch torchvision lightning Scikit-image imageio pillow==10.0.0 Scikit-learn Matplotlib plotly barviz numpy==1.23.3 Pandas Pandoc pyyaml Jupyterlab fidle
|
|
(fidle-env) $ pip install --extra-index-url https://download.pytorch.org/whl/cpu \
|
|
|
|
torch \
|
|
|
|
torchvision \
|
|
|
|
torch-geometric \
|
|
|
|
torchtext \
|
|
|
|
torchdata \
|
|
|
|
lightning \
|
|
|
|
tensorboard \
|
|
|
|
keras \
|
|
|
|
transformers \
|
|
|
|
numpy \
|
|
|
|
Scikit-image \
|
|
|
|
Scikit-learn \
|
|
|
|
Matplotlib \
|
|
|
|
plotly \
|
|
|
|
seaborn \
|
|
|
|
barviz \
|
|
|
|
pyarrow \
|
|
|
|
Pandas \
|
|
|
|
Pandoc \
|
|
|
|
pyyaml \
|
|
|
|
Jupyterlab \
|
|
|
|
fidle
|
|
```
|
|
```
|
|
|
|
|
|
It will take a little while, but should go very well :-)
|
|
It will take a little while, but should go very well :-)
|
|
|
|
|
|
## 4 - Install notebooks et datasets
|
|
## 4 - Install notebooks et datasets
|
|
|
|
|
|
Now all that remains is to install the notebooks and datasets :-)
|
|
Now all that remains is to install the notebooks and datasets :-)\
|
|
Nous allons faire cela avec la commande `fid` de Fidle.
|
|
Nous allons faire cela avec la commande `fid` de Fidle.
|
|
|
|
|
|
Toujours depuis notre dossier `fidle-tp`
|
|
Toujours depuis notre dossier `fidle-tp`
|
|
```
|
|
|
|
|
|
```plaintext
|
|
(fidle-env) $ fid install --quiet
|
|
(fidle-env) $ fid install --quiet
|
|
```
|
|
```
|
|
You should have something like :
|
|
|
|
|
|
You should have something like :\
|
|
(version numbers may vary)
|
|
(version numbers may vary)
|
|
```
|
|
|
|
|
|
```plaintext
|
|
==========================================================
|
|
==========================================================
|
|
fid - Your favorite Fidle admin command :-) (v2.2b10)
|
|
fid - Your favorite Fidle admin command :-) (v2.2b10)
|
|
==========================================================
|
|
==========================================================
|
... | @@ -93,6 +120,7 @@ Done. |
... | @@ -93,6 +120,7 @@ Done. |
|
## 5 - Installation check
|
|
## 5 - Installation check
|
|
|
|
|
|
The tree structure is normally as follows:
|
|
The tree structure is normally as follows:
|
|
|
|
|
|
```plaintext
|
|
```plaintext
|
|
fidle-tp
|
|
fidle-tp
|
|
├── fidle-master-2.2.4 Contains notebooks
|
|
├── fidle-master-2.2.4 Contains notebooks
|
... | @@ -100,17 +128,19 @@ The tree structure is normally as follows: |
... | @@ -100,17 +128,19 @@ The tree structure is normally as follows: |
|
└── fidle-env Virtual environment
|
|
└── fidle-env Virtual environment
|
|
```
|
|
```
|
|
|
|
|
|
**From a terminal**, go to your `fidle-tp` folder,
|
|
**From a terminal**, go to your `fidle-tp` folder,\
|
|
activate the `fidle-env` environment and do a `fid check`.
|
|
activate the `fidle-env` environment and do a `fid check`.
|
|
```
|
|
|
|
|
|
```plaintext
|
|
$ cd (...)/fidle-tp
|
|
$ cd (...)/fidle-tp
|
|
$ source ./fidle-env/bin/activate
|
|
$ source ./fidle-env/bin/activate
|
|
(fidle-env) $ fid check
|
|
(fidle-env) $ fid check
|
|
```
|
|
```
|
|
|
|
|
|
You should have something like :
|
|
You should have something like :\
|
|
(version numbers may vary)
|
|
(version numbers may vary)
|
|
```
|
|
|
|
|
|
```plaintext
|
|
==========================================================
|
|
==========================================================
|
|
fid - Your favorite Fidle admin command :-) (v2.2b10)
|
|
fid - Your favorite Fidle admin command :-) (v2.2b10)
|
|
==========================================================
|
|
==========================================================
|
... | @@ -149,19 +179,20 @@ Check environment : |
... | @@ -149,19 +179,20 @@ Check environment : |
|
|
|
|
|
## 6 - Start Jupyter lab
|
|
## 6 - Start Jupyter lab
|
|
|
|
|
|
Very easy :-)
|
|
Very easy :-)\
|
|
**From a terminal**, go to your `fidle-tp` folder,
|
|
**From a terminal**, go to your `fidle-tp` folder,\
|
|
activate the `fidle-env` environment and do a `jupyter lab`.
|
|
activate the `fidle-env` environment and do a `jupyter lab`.
|
|
|
|
|
|
```
|
|
```plaintext
|
|
$ cd (...)/fidle-tp
|
|
$ cd (...)/fidle-tp
|
|
$ source ./fidle-env/bin/activate
|
|
$ source ./fidle-env/bin/activate
|
|
(fidle-env) $ jupyter lab
|
|
(fidle-env) $ jupyter lab
|
|
```
|
|
```
|
|
|
|
|
|
**Note:**
|
|
**Note:**
|
|
|
|
|
|
- You can reinstall notebooks or datasets with the `fid install_notebooks` and `fid install_datasets` commands
|
|
- You can reinstall notebooks or datasets with the `fid install_notebooks` and `fid install_datasets` commands
|
|
- You can also locate the datasets fidle folder anywhere you want.
|
|
- You can also locate the datasets fidle folder anywhere you want.\
|
|
In this case, you must specify the location of this folder with the environment variable `FIDLE_DATASETS_DIR`
|
|
In this case, you must specify the location of this folder with the environment variable `FIDLE_DATASETS_DIR`
|
|
|
|
|
|
[Back to the install procedure](Using%20Fidle/install%20fidle)
|
|
[Back to the install procedure](Using%20Fidle/install%20fidle)
|
... | | ... | |