Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/franzdiebold/dockerize-datascience

Dockerize Data Science
https://github.com/franzdiebold/dockerize-datascience

bash bashrc data-science datascience docker jupyter python

Last synced: 4 months ago
JSON representation

Dockerize Data Science

Host: GitHub
URL: https://github.com/franzdiebold/dockerize-datascience
Owner: FranzDiebold
License: mit
Created: 2022-02-21T09:42:38.000Z (almost 3 years ago)
Default Branch: main
Last Pushed: 2022-11-21T20:31:28.000Z (about 2 years ago)
Last Synced: 2024-05-02T02:49:37.240Z (10 months ago)
Topics: bash, bashrc, data-science, datascience, docker, jupyter, python
Language: Shell
Homepage:
Size: 191 KB
Stars: 21
Watchers: 2
Forks: 2
Open Issues: 0
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE

Awesome Lists containing this project

README

        # Dockerize Data Science

> Bring your Data Science tasks to Docker! :whale:

[![Medium article: How to dockerize Data Science](https://img.shields.io/badge/Medium%20article-How%20to%20dockerize%20python%20environments-black)](https://franzdiebold.medium.com/how-to-dockerize-python-environments-ce8d2ce7bf32)

[![Medium article: How to dockerize Data Science](https://img.shields.io/badge/Medium%20article-How%20to%20dockerize%20Data%20Science-black)](https://franzdiebold.medium.com/how-to-dockerize-data-science-dd396962a0f)

[![GitHub license](https://img.shields.io/github/license/FranzDiebold/dockerize-datascience)](./LICENSE)

!["Docker, Docker everywhere" meme](img/docker-everywhere-meme.jpg)

This is the code repository for the accompanying Medium article series _"How to dockerize [x]"_:

- [_"How to dockerize Python environments"_](https://franzdiebold.medium.com/how-to-dockerize-python-environments-ce8d2ce7bf32)

- [_"How to dockerize Data Science"_](https://franzdiebold.medium.com/how-to-dockerize-data-science-dd396962a0f)

## Installation

Add the content of [`dockerize-datascience.sh`](dockerize-datascience.sh) to your `.bashrc` or `.zshrc` file.

## Usage

### Python

Choose your Python version:

| Python version | Command      |

| -------------: | ------------ |

|            3.8 | `python3.8`  |

|            3.9 | `python3.9`  |

|           3.10 | `python3.10` |

|           3.11 | `python3.11` |

|         latest | `python`     |

This will run your python script or your interactive Python session in a _Docker container_. The current directory is mounted into the container.

If you want to install dependencies, you should use the _Python environment_.

### Python environment

In order to create a new or use an existing Python environment, run one of the following commands in your _project folder_:

| Python version | Command       |

| -------------: | ------------- |

|            3.8 | `py-env-3.8`  |

|            3.9 | `py-env-3.9`  |

|           3.10 | `py-env-3.10` |

|           3.11 | `py-env-3.11` |

|         latest | `py-env`      |

The current directory is mounted into the container.

To delete the environment run `py-env-del` in your project folder.

### Jupyter (JupyterLab)

!["Dockerizing Data Science" meme](img/dockerizing-data-science-meme.jpg)

For [Jupyter](https://jupyter.org/) (to use in the browser) run

```shell

jupyter

```

This uses the [`franzdiebold/datascience-ultimate`](https://github.com/FranzDiebold/docker-datascience-ultimate) Docker image.

The current directory is mounted into the container.

If you want to install dependencies, you should use the [Jupyter environment](#jupyter-environment).

### Jupyter environment

In order to create a new or use an existing Jupyter environment, run the following command in your _project folder_:

```shell

jupyter-env

```

or shorter

```shell

je

```

This uses the [`franzdiebold/datascience-ultimate`](https://github.com/FranzDiebold/docker-datascience-ultimate) Docker image.

The current directory is mounted into the container.

To delete the environment run `jupyter-env-del`.

---

### Jupyter Server

For [Jupyter Server](https://jupyter.org/) (to use with a different client software for your notebooks such as [JetBrains DataSpell](https://www.jetbrains.com/dataspell/)) run

```shell

jupyter-server

```

This uses the [`franzdiebold/datascience-ultimate-server`](https://github.com/FranzDiebold/docker-datascience-ultimate) Docker image.

The current directory is mounted into the container.

If you want to install dependencies, you should use the [Jupyter Server environment](#jupyter-server-environment).

### Jupyter Server environment

In order to create a new or use an existing Jupyter Server environment, run the following command in your _project folder_:

```shell

jupyter-server-env

```

or shorter

```shell

jes

```

This uses the [`franzdiebold/datascience-ultimate-server`](https://github.com/FranzDiebold/docker-datascience-ultimate) Docker image.

The current directory is mounted into the container.

To delete the environment run `jupyter-server-env-del`.