feat: Add Docker and Docker Compose Support (#140)

## Description

Added Docker support for the project
* added `Dockerfile` for building environment
* `docker-compose.yaml`for volume mounting
* added `README` for instructing on building and testing

## Checklist

Go over all the following points, and put an `x` in all the boxes that
apply.

- [x] I have read the
[CONTRIBUTION](https://github.com/camel-ai/oasis/blob/master/CONTRIBUTING.md)
guide (**required**)
- [x] I have linked this PR to an issue using the Development section on
the right sidebar or by adding `Fixes #issue-number` in the PR
description (**required**)
- [x] I have checked if any dependencies need to be added or updated in
`pyproject.toml`
- [x] I have updated the tests accordingly (*required for a bug fix or a
new feature*)
- [x] I have updated the documentation if needed:
- [ ] I have added examples if this is a new feature

Fixed #127

Author: zhangzaibin

.container/.env.example

@@ -0,0 +1,18 @@
+# Necessary Keys
+OPENAI_API_KEY=sk-123456789
+
+# Optional Keys
+# For Jina URL Reader
+JINA_API_KEY=jina_123456789
+
+# For Cohere Rerank
+COHERE_API_KEY=abcdefghi
+
+# For Google Search API
+# https://developers.google.com/custom-search/v1/overview
+GOOGLE_API_KEY=123456789
+# https://cse.google.com/cse/all
+SEARCH_ENGINE_ID=123456789
+
+# For OpenWeatherMap API
+OPENWEATHERMAP_API_KEY=123456789

.container/Dockerfile

@@ -0,0 +1,22 @@
+FROM python:3.10-bookworm
+
+# Install uv and common tools
+RUN apt-get update && apt-get install -y curl git && \
+    pip install uv && \
+    rm -rf /var/lib/apt/lists/*
+
+# Set workdir
+WORKDIR /app/oasis
+
+# Copy code
+COPY . .
+
+# Set up venv + install dev deps
+RUN uv venv .venv --python=3.10 && \
+    . .venv/bin/activate && \
+    uv pip install -e ".[dev]" && \
+    pip install pre-commit mypy && \
+    pre-commit install
+
+# Keep container alive for development
+CMD ["tail", "-f", "/dev/null"]

.container/README.md

@@ -0,0 +1,85 @@
+# Install OASIS with Docker
+
+Docker provides a consistent and isolated environment to build, run, and develop oasis without worrying about system dependencies. This guide walks you through setting up oasis using Docker, running it, and developing with it.
+
+## Prerequisites
+- Docker：https://docs.docker.com/engine/install/
+- Docker Compose：https://docs.docker.com/compose/install/
+
+## Configure Environment
+Before starting the container, you need to navigate into the
+[.container](../.container) folder and create a `.env` file **with your own 
+API keys**, so that these keys will be present in the environment variables of 
+the container, which will later be used by OASIS. 
+
+```bash
+cd .container
+
+# Create your own .env file by copying the example
+cp .env.example .env
+
+# Edit .env to add your API keys or custom settings
+```
+
+## Start Container
+To build and start the development container:
+
+```bash
+docker compose up -d
+```
+This will:
+* Build the image oasis:localdev
+* Start the container oasis-localdev
+* Set up all necessary dependencies
+
+After the build is complete, you can verify the list of images and all running containers.
+
+```bash
+# List all Docker images
+docker images
+# Check running containers       
+docker ps             
+```
+
+## Enter the Container
+Once running, you can access the container like this:
+
+```bash
+docker compose exec oasis bash
+```
+You’ll now be inside the oasis dev environment.
+
+From here, you can activate your virtual environment (if used) and run tests:
+```bash
+# Any other dev/test command
+pytest                 
+pre-commit run --all-files
+```
+
+## Save Your Progress
+Your local code is volume-mounted into the container. That means any changes you make inside the container are reflected in your local project folder — no need to worry about losing your work.
+
+## Exit, Stop and Delete the Container
+You can simply press `Ctrl + D` or use the `exit` command to exit the
+container.
+
+After exiting the container, under normal cases the container will still be 
+running in the background. If you don't need the container anymore, you can 
+stop and delete the container with the following command.
+
+```bash
+docker compose down
+```
+
+## Online Images
+For users who only want to have a quick tryout on OASIS, we also provide the 
+pre-built images on
+[our GitHub Container Registry]().
+
+## Pre-built Image (Optional)
+If you only want to try oasis without setting up the build:
+
+```bash
+
+```
+

.container/docker-compose.yaml

@@ -0,0 +1,12 @@
+services:
+  oasis:
+    image: oasis:localdev
+    container_name: oasis-localdev
+    build:
+      context: ../
+      dockerfile: .container/Dockerfile
+    volumes:
+      - ../:/app/oasis
+    env_file:
+      - .env
+    command: ["tail", "-f", "/dev/null"]