Skip to content

Latest commit

 

History

History

README.md

lens

Your 👁 on the ☀️

Install the docker that is shown ⬇️, and rock this shit

python-opencv-notebook

Ready to run jupyter notebook in docker, with Python 3.6, OpenCV 3.3, OpenCV contrib, and some recommended python libraries for data science (numpy, pandas, sklearn, etc).

Usage

  1. Install Docker CE - for Mac, for Windows or for Ubuntu

  2. Run this command from your project directory:

    docker run --interactive --tty --init --rm --name opencv-notebook --publish 8888:8888 --volume `pwd`/data:/app/data alexlouden/python-opencv-notebook

    The data directory will be created, shared with the docker container, and the jupyter notebook will be launched from here.

    Run Control + C to shut down the notebooks and stop the docker container.

    See docker docs for more info.

  3. You should see the following output:

    Copy/paste this URL into your browser when you connect for the first time, to login with a token: http://localhost:8888/?token=longsecrettoken

    Open the URL in your browser, and you should get access!

Notes

  • Aims to be a lot simpler and easier to understand than https://github.com/jupyter/docker-stacks
  • Uses the python 3.6.3 base docker image
  • Uses pip rather than conda (installs from requirements.txt)
  • No virtualenv - uses the docker container's system Python
  • Designed to run on your computer (not a public server) - no SSL, no password, runs as root docker user.

Building from source

You can clone this repo and build the image yourself with:

git clone git@github.com:alexlouden/python-opencv-notebook.git
cd python-opencv-notebook
docker build -t python-opencv-notebook .