feat: add Docker configuration for Hugging Face Spaces deployment

.dockerignore

@@ -0,0 +1,21 @@
+# Python ignores
+__pycache__/
+*.py[cod]
+*$py.class
+venv/
+.env
+
+# Project specific
+examples/rpg_character_config.json
+*.png
+comfy_node_info.json
+
+# Tooling
+.vscode/
+.idea/
+.git/
+commit_msg.txt
+
+# OS
+.DS_Store
+Thumbs.db

Dockerfile

@@ -0,0 +1,31 @@
+# Use official Python image
+FROM python:3.10-slim
+
+# Set working directory
+WORKDIR /app
+
+# Create a non-root user (Hugging Face standard)
+RUN useradd -m -u 1000 user
+USER user
+ENV HOME=/home/user \
+    PATH=/home/user/.local/bin:$PATH
+
+# Set working directory to app and ensure ownership
+WORKDIR $HOME/app
+
+# Copy requirements and install
+COPY --chown=user requirements.txt .
+RUN pip install --no-cache-dir --upgrade -r requirements.txt
+
+# Copy the rest of the application
+COPY --chown=user . .
+
+# Hugging Face Spaces standard port
+EXPOSE 7860
+
+# Set environment variables for Gradio to run on 0.0.0.0:7860
+ENV GRADIO_SERVER_NAME="0.0.0.0" \
+    GRADIO_SERVER_PORT=7860
+
+# Command to run the application
+CMD ["python", "app.py"]

commit_msg.txt

@@ -1,7 +0,0 @@
-refactor: modularize codebase and reorganize utilities
-
-- Split monolithic app.py into modules/config.py, modules/integrations.py, modules/core_logic.py, and modules/ui_layout.py.
-- Consolited ComfyUI utilities into a dedicated comfy/ directory.
-- Updated imports to use the new package structure.
-- Enhanced .gitignore to include __pycache__ and temporary character saves.
-- Documented new architecture and safer port management in design.md.

design.md

@@ -67,6 +67,8 @@ The app uses a 3-stage prompt pipeline:
 - **`modules/ui_layout.py`**: The full Gradio UI definition (`build_ui`).
 - **`comfy/`**: Dedicated folder for ComfyUI-specific JSON workflows and utility scripts.
 
-### 3. Documentation & Artifacts
-- **Path Formatting**: For markdown artifacts (like `walkthrough.md`), use absolute paths for media embeds. On Windows, prefix with a leading slash (e.g., `/C:/Users/...`) to comply with internal linting and ensuring reliable rendering.
-- **Visual Proof**: Capture final screenshots of UI layouts to provide immediate visual confirmation of successes, especially after complex layout reorganizations.
+### 3. Deployment (Hugging Face Spaces)
+- **Containerization**: The app is containerized using the provided `Dockerfile` and `.dockerignore`.
+- **User Permissions**: The Dockerfile uses `useradd -m -u 1000 user` to comply with Hugging Face's security requirements for non-root users.
+- **Port Mapping**: Hugging Face Spaces expects the app on port 7860. The `GRADIO_SERVER_NAME="0.0.0.0"` and `GRADIO_SERVER_PORT=7860` environment variables ensure the app is bound correctly for external routing.
+- **Local Testing**: Run `docker-compose up --build` to verify the deployment state locally.

docker-compose.yaml

@@ -0,0 +1,12 @@
+version: '3.8'
+
+services:
+  rpg-portrait:
+    build: .
+    ports:
+      - "7860:7860"
+    env_file:
+      - .env
+    volumes:
+      - ./examples:/home/user/app/examples
+    restart: unless-stopped

requirements.txt

@@ -3,3 +3,4 @@ PyYAML
 python-dotenv
 google-genai
 requests
+Pillow