https://github.com/speaud/jupyter-runtime-template

Containerized Jupyter Lab Scientific Python Stack runtime built in Ubuntu environment with kernels to execute Java, Go, Node/JavaScript/TypeScript, Haskell, and Python code
https://github.com/speaud/jupyter-runtime-template

docker go haskell ipython jupyter-lab node python typescript ubuntu

Last synced: 24 days ago
JSON representation

Containerized Jupyter Lab Scientific Python Stack runtime built in Ubuntu environment with kernels to execute Java, Go, Node/JavaScript/TypeScript, Haskell, and Python code

• Host: GitHub
• URL: https://github.com/speaud/jupyter-runtime-template
• Owner: speaud
• Created: 2023-05-09T20:07:45.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-08-10T14:29:41.000Z (3 months ago)
• Last Synced: 2024-09-29T18:23:46.451Z (about 1 month ago)
• Topics: docker, go, haskell, ipython, jupyter-lab, node, python, typescript, ubuntu
• Language: Jupyter Notebook
• Homepage:
• Size: 111 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# About

Containerized [Jupyter Lab Scientific Python Stack](https://hub.docker.com/r/jupyter/scipy-notebook) runtime build on a Ubuntu distribution to include kernels to execute code from the following languages

1. Python 3 (by default)

1. [Go](https://github.com/gopherdata/gophernotes)

1. [Java](https://github.com/SpencerPark/IJava)

1. [JavaScript/Node](https://github.com/n-riesco/ijavascript)

1. [TypeScript](https://github.com/yunabe/tslab)

![alt text](jupyter_lab_launcher_snippet.png)

Aldo, by using the [built-in magic commands](https://ipython.readthedocs.io/en/stable/interactive/magics.html#built-in-magic-commands) and [IPython extensions](https://ipython.readthedocs.io/en/stable/config/extensions/index.html), this template provides the developer with features such as[`autoreload`](https://ipython.readthedocs.io/en/stable/config/extensions/autoreload.html#autoreload) out of the box. The Docker volume mapping configuration provides persisted state for all notebooks and modules.

# Run Locally

> ⚠️ stable-ish, proceed with caution

## Requirements

[Docker](https://docs.docker.com/)

```

Client: Docker Engine - Community

 Version:           18.09.2

 API version:       1.39

 Go version:        go1.10.8

 Git commit:        6247962

 Built:             Sun Feb 10 04:12:39 2019

 OS/Arch:           darwin/amd64

 Experimental:      false

Server: Docker Engine - Community

 Engine:

  Version:          18.09.2

  API version:      1.39 (minimum version 1.12)

  Go version:       go1.10.6

  Git commit:       6247962

  Built:            Sun Feb 10 04:13:06 2019

  OS/Arch:          linux/amd64

  Experimental:     true

```

## Steps

1. Clone

2. Setup `.env` as outlined in `~/.env.template` file

3. Run `bin/build.bash` (no need to re-run the build if there are no new Docker-related or configuration changes)

4. Run `bin/run.bash`, monitor the terminal outputs, then visit [http://127.0.0.1:8888/lab](http://127.0.0.1:8888/lab) to access the interface

### Additional Runtime Commands (custom)

| Command | Details |

| -------- | ------- |

| `bin/exec.bash` | Tunnel into the running then open a [interactive shell session](https://docs.docker.com/reference/cli/docker/container/exec/) |

| `bin/test.bash` | Run tests |

| `bin/setenv.bash` | Injects environment variables from the `.env` file into runtime environment |

Note you can pass [Docker flags](https://docs.docker.com/engine/reference/run/) to executables such as `bin/build.bash --no-cache`