add instructions on readme

Author: ks6088ts

README.md

@@ -34,3 +34,40 @@ Here are the preferred tools for development.
 | [7_streamlit_chat_rag](./apps/7_streamlit_chat_rag/README.md)                     | Add RAG feature to Streamlit chat app                   | ![7_streamlit_chat_rag](./docs/images/7_streamlit_chat_rag.main.png)                     |
 | [8_streamlit_azure_openai_batch](./apps/8_streamlit_azure_openai_batch/README.md) | Call Azure OpenAI Batch API with Streamlit              | ![8_streamlit_azure_openai_batch](./docs/images/8_streamlit_azure_openai_batch.main.png) |
 | [99_streamlit_examples](./apps/99_streamlit_examples/README.md)                   | Code samples for Streamlit                              | ![99_streamlit_examples](./docs/images/99_streamlit_examples.explaindata.png)            |
+
+## How to run
+
+Referring to the [.env.template](.env.template) file, create a `.env` file in the same directory and set the required credentials.
+
+### Local environment
+
+```shell
+# Create a virtual environment
+$ python -m venv .venv
+
+# Activate the virtual environment
+$ source .venv/bin/activate
+
+# Install dependencies
+$ pip install -r requirements.txt
+
+# Run the script (e.g. run 2_streamlit_chat)
+$ python -m streamlit run apps/2_streamlit_chat/main.py
+```
+
+### Docker container
+
+```shell
+# Set Docker image name
+## GitHub Container Registry
+$ IMAGE=ghcr.io/ks6088ts-labs/workshop-azure-openai:latest
+## Docker Hub
+$ IMAGE=ks6088ts/workshop-azure-openai:latest
+
+# run 2_streamlit_chat
+$ docker run --rm \
+    -p 8501:8501 \
+    -v ${PWD}/.env:/app/.env \
+    ${IMAGE} \
+    python -m streamlit run ./apps/2_streamlit_chat/main.py
+```