jupyter.md

wine_quality

Summary

Udacity course on data science.

Table of Contents

• wine_quality
  • Summary
  • Setup
  • Usage
    • Poetry
    • Docker
    • Both
  • TODO
  • Further Reading

Setup

• Install
  • editorconfig
  • asdf
  • poetry
  • docker
• Download CSVs from here
  • Move to csv directory

Usage

Poetry

• Install requirements via Poetry:

  poetry install
  poetry run ipython kernel install --name "python3.10.7" --user

• Run Jupyter Lab

  poetry shell
  jupyter lab --ip=0.0.0.0 --port=8888 --no-browser

• Quit the server via ctrl-c in the terminal
• Enter deactivate to exit the Poetry virtual environment

Docker

• Customize the .env.example and rename to .env
• General commands

  # build image locally
  docker-compose build --pull --no-cache
  
  # start container
  docker-compose up -d
  
  # stop container
  docker-compose stop
  
  # remove container and network
  docker-compose down

• justfile syntax (recommended)

  # help
  just
  
  # build image locally (no-cache)
  just build-clean
  
  # build image locally
  just build
  
  # start container
  just start
  
  # ssh
  just exec
  
  # stop container
  just stop
  
  # stop container, remove container and network
  just down

Both

• Open a browser and navigate to http://127.0.0.1:8888
  • Docker uses the token specified in .env
• Select the "python3.10.7" kernel if asked
• Open refactor-wine-quality.ipynb from the left-hand column
• Run cells by selecting them and pressing shift-enter

TODO

• Get Jupyter working in VSCode
  • Multiple localhost entries in /etc/hosts 😭

Further Reading

Original Repo

Starting JupyterLab

Jupyter Docker Stacks — Docker Stacks documentation

Dockerizing Jupyter Projects