Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
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:
[](https://franzdiebold.medium.com/how-to-dockerize-python-environments-ce8d2ce7bf32)
[](https://franzdiebold.medium.com/how-to-dockerize-data-science-dd396962a0f)
[](./LICENSE)
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)

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`.