README.md

streamlit-docker-template

Template repository to create a dockerized Streamlit application from scratch.

If you want to create Streamlit application, select this repo as a templated when creating your app's repository.

Run with docker-compose :

Pre-requisites

• Docker installed and running
• docker-compose installed

$ docker-compose up

# When dependencies change and you need to force a rebuild
$ docker-compose up --build

# When finished
$ docker-compose down

Run with virtualenv:

Pre-requisites

• pip
• poetry

# Installing dependencies and activating the virtualenv

$ poetry install
$ poetry shell

$ streamlit run app.py

Run with docker:

• Docker installed and running

# First build
$ docker build -t streamlit-app:latest .

# Subsequent builds
$ docker build --cache-from streamlit-app:latest -t streamlit-app:latest .

# To run as docker container with default streamlit port
$ docker run -p 8501:8501 streamlit-app:latest

You can open the app at http://localhost:8501

Further developing your application

We recommend developing the app using the virtualenv instructions above. This way you can add dependencies like this:

# Adding pandas as a dependency
$ poetry add pandas

Then poetry will update your pyproject.toml so that no change to the Dockerfile is necessary.