CHIME

The COVID-19 Hospital Impact Model for Epidemics

Interested in contributing?

Join our Code For Philly project or our Slack workspace in the #covid19-chime-penn channel if you'd like to chat with us. We'd appreciate your feedback.

Development

To test the app locally just run:

streamlit run app.py

This will open a browser window with the app running on port 8000. If you need the app to run on another port, you can edit .streamlit/config.toml, or use the magic ENV var, STREAMLIT_SERVER_PORT - see this streamlit issue. So, for example, to run the app on port 1234, you would change the last line of config.toml to port = 1234 or invoke the app like this:

STREAMLIT_SERVER_PORT=1234 streamlit run app.py

With pipenv

pipenv shell
pipenv install
streamlit run app.py

With conda

conda env create -f environment.yml
source activate chime
pip install streamlit
streamlit run app.py

Developing with docker

Copy .env.example to be .env and run the container.

cp .env.example .env
docker-compose up

You should be able to view the app via localhost:8000. If you want to change the port (as described above), then you also have to set PORT in the .env file.

NOTE this is just for usage, not for development--- you would have to restart and possibly rebuild the app every time you change the code.

If you'd like to use docker-compose for development, please run docker-compose up --build every time you make changes.

Deployment

Before you push your changes to master make sure that everything works in development mode.

Changes merged to master will be automatically deployed to http://penn-chime.phl.io/.