Fix Docker multi-architecture support and PYTHONPATH issues

Co-authored-by: ks6088ts <[email protected]>

Author: Copilot

.github/workflows/docker-release.yaml

@@ -6,10 +6,12 @@ on:
 jobs:
   release:
     runs-on: "ubuntu-latest"
-    timeout-minutes: 5
+    timeout-minutes: 10
     steps:
       - name: Check out the repo
         uses: actions/checkout@v5
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
       - name: Log in to Docker Hub
         uses: docker/login-action@v3
         with:
@@ -32,6 +34,7 @@ jobs:
         uses: docker/build-push-action@v6
         with:
           context: .
+          platforms: linux/amd64,linux/arm64
           push: true
           build-args: |
             GIT_REVISION=${{ github.sha }}

Dockerfile

@@ -37,4 +37,7 @@ RUN pip install --no-cache-dir --upgrade -r /app/requirements.txt
 # Copy application code after dependencies are installed
 COPY . .
 
+# Set PYTHONPATH to include the working directory for module imports
+ENV PYTHONPATH="${PYTHONPATH}:/app"
+
 CMD ["python", "template_langgraph/core.py"]

Makefile

@@ -76,6 +76,14 @@ docker-build: ## build Docker image
 docker-run: ## run Docker container
 	docker run --rm $(DOCKER_REPO_NAME)/$(DOCKER_IMAGE_NAME):$(GIT_TAG) $(DOCKER_COMMAND)
 
+.PHONY: docker-run-streamlit
+docker-run-streamlit: ## run Docker container with Streamlit app
+	docker run --rm \
+		-p 8501:8501 \
+		-v $(PWD)/.env:/app/.env \
+		$(DOCKER_REPO_NAME)/$(DOCKER_IMAGE_NAME):$(GIT_TAG) \
+		streamlit run template_langgraph/services/streamlits/main.py --server.address 0.0.0.0
+
 .PHONY: docker-lint
 docker-lint: ## lint Dockerfile
 	docker run --rm -i hadolint/hadolint < Dockerfile

docs/index.md

@@ -240,6 +240,43 @@ Demonstration of the Streamlit app:
 
 [![streamlit.png](./images/streamlit.png)](https://youtu.be/undxBwyJ3Sc)
 
+### Option 6: Docker (Production deployment)
+
+You can run the application in Docker for consistent deployment across environments:
+
+#### Building the Docker Image
+
+```shell
+# Build the Docker image locally
+make docker-build
+
+# Or build with specific tag
+docker build -t ks6088ts/template-langgraph:latest .
+```
+
+#### Running Streamlit in Docker
+
+```shell
+# Run Streamlit app with Docker
+make docker-run-streamlit
+
+# Or run manually with environment file
+docker run --rm \
+  -p 8501:8501 \
+  -v ./.env:/app/.env \
+  ks6088ts/template-langgraph:latest \
+  streamlit run template_langgraph/services/streamlits/main.py --server.address 0.0.0.0
+```
+
+#### Multi-Architecture Support
+
+The Docker images are built for both `amd64` and `arm64` architectures, making them compatible with:
+- Intel/AMD x64 processors
+- Apple Silicon (M1/M2/M3/M4) processors
+- ARM-based servers
+
+Access the Streamlit app at [http://localhost:8501](http://localhost:8501) after running the container.
+
 ### More agent runs
 
 - Issue formatter (structured output):