guide on the usage of docker

README.md

@@ -58,18 +58,11 @@ The easiest way to start playing is
  2. Copy OAI_CONFIG_LIST_sample to ./notebook folder, name to OAI_CONFIG_LIST, and set the correct configuration.
  3. Start playing with the notebooks!
 
-## Using existing docker image
-Install docker, save your oai key into an environment variable name OPENAI_API_KEY, and then run the following.
-
-```
-docker pull yuandongtian/autogen:latest
-docker run -it -e OPENAI_API_KEY=$OPENAI_API_KEY -p 8081:8081 docker.io/yuandongtian/autogen:latest
-```
-
-Then open `http://localhost:8081/` in your browser to use AutoGen. The UI is from `./samples/apps/autogen-assistant`. See docker hub [link](https://hub.docker.com/r/yuandongtian/autogen) for more details.
-
 ## Installation
 
+### Option 1. [Run AutoGen in Docker (recommended)](https://microsoft.github.io/autogen/docs/Installation#option-1-using-docker)
+
+### Option 2. Install AutoGen without Docker
 AutoGen requires **Python version >= 3.8, < 3.12**. It can be installed from pip:
 
 ```bash

samples/dockers/Dockerfile.user

@@ -0,0 +1,21 @@
+FROM python:3.11-slim
+
+RUN : \
+    && apt-get update \
+    && DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends \
+        software-properties-common \
+    && DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends \
+        python3-venv \
+    && apt-get clean \
+    && rm -rf /var/lib/apt/lists/* \
+    && :
+
+RUN python3 -m venv /venv
+ENV PATH=/venv/bin:$PATH
+EXPOSE 8081
+
+RUN cd /venv; pip install pyautogen autogenra
+RUN pip install yfinance numpy scipy matplotlib pandas
+RUN pip install beautifulsoup4
+
+ENTRYPOINT []

website/docs/Contribute.md

@@ -97,12 +97,8 @@ pip install -e autogen
 
 ### Docker
 
-We provide a simple [Dockerfile](https://github.com/microsoft/autogen/blob/main/Dockerfile).
+We provide [Dockerfiles](https://github.com/microsoft/autogen/blob/main/sample/dockers/).
 
-```bash
-docker build https://github.com/microsoft/autogen.git#main -t autogen-dev
-docker run -it autogen-dev
-```
 
 ### Develop in Remote Container
 

website/docs/Installation.md

@@ -1,10 +1,46 @@
 # Installation
 
-## Setup Virtual Environment
+## Option 1: Using Docker (Recommended)
+#### Step 1. Install [docker](https://www.docker.com/).
+
+Docker is recommended as a properly built docker image could provide isolated and consistent environment to run your code securely across platforms. Install docker following [this instruction](https://docs.docker.com/get-docker/).
+
+#### Step 2. Build a docker image
+
+AutoGen provides [dockerfiles](https://github.com/microsoft/autogen/tree/main/samples/dockers/) that could be used to built docker images. Use the following command line to build a docker image named `autogen_img` (or some other name you like) one of the provided dockerfile:
+```
+docker build -f sample/docker/Dockerfile.user -t autogen_img https://github.com/microsoft/autogen.git
+```
+Once you build the docker image, you can use `docker images` to check whether it has been created successfully.
+
+#### Step 3.  Run applications built with AutoGen from a docker image.
+
+**Save keys into environment variable:**
+If your application needs an oai key, save your oai key into an environment variable `OPENAI_API_KEY`, which can be done by adding the following line in your `~/.bashrc` (or `~/.zshrc`),
+
+```
+export OPENAI_API_KEY="sk-xxxxxx"
+```
+
+**Mount your code to the docker image and run your application from there:** Now suppose you have your application built with AutoGen in a folder named `myapp`. You can mount it into the docker image and run it. In the example below, the folder `myapp` is mounted into `/myapp` in the docker, and the script `main_twoagent.py` is executed in the docker.
+
+```python
+# Mount the local folder `myapp` into docker image and run the script in the docker.
+docker run -it -e OPENAI_API_KEY=$OPENAI_API_KEY -v `pwd`/myapp:/myapp autogen_img:latest python /myapp/main_twoagent.py
+```
+
+Similarly, you may also run [AutoGen Studio](https://github.com/microsoft/autogen/tree/main/samples/apps/autogen-studio) as below:
+
+```
+docker run -it -e OPENAI_API_KEY=$OPENAI_API_KEY -p 8081:8081 autogen_img:latest autogenra ui --host 0.0.0.0
+```
+Then open `http://localhost:8081/` in your browser to use AutoGen assistant.
+
+## Option 2: Use Virtual Environment
 
 When not using a docker container, we recommend using a virtual environment to install AutoGen. This will ensure that the dependencies for AutoGen are isolated from the rest of your system.
 
-### Option 1: venv
+### Option a: venv
 
 You can create a virtual environment with `venv` as below:
 ```bash
@@ -17,7 +53,7 @@ The following command will deactivate the current `venv` environment:
 deactivate
 ```
 
-### Option 2: conda
+### Option b: conda
 
 Another option is with `Conda`, Conda works better at solving dependency conflicts than pip. You can install it by following [this doc](https://docs.conda.io/projects/conda/en/stable/user-guide/install/index.html),
 and then create a virtual environment as below:
@@ -31,7 +67,7 @@ The following command will deactivate the current `conda` environment:
 conda deactivate
 ```
 
-### Option 3: poetry
+### Option c: poetry
 
 Another option is with `poetry`, which is a dependency manager for Python.