Add step-by-step Docker documentation with configuration selection and manual commands

[Copilot]

Docker setup documentation lacked clear step-by-step instructions and a manual alternative to the build script.

Changes

• Added Step 1: Configuration Selection

  • ls config/ command with descriptions of common configs (minicpm for local testing, openai_compatible for cloud APIs)

• Added Step 2: Build and Run Options

  • Option A: Existing build_and_run.sh script (easiest)
  • Option B: Manual Docker commands with correct paths and build args

Manual commands align with build_and_run.sh:

# Build with config-specific dependencies
docker build -t openavatarchat:latest --build-arg CONFIG_FILE=config/chat_with_minicpm.yaml .

# Run with proper volume mounts
docker run -d \
  --name openavatarchat \
  --gpus all \
  -p 8282:8282 \
  -v $(pwd)/build:/root/open-avatar-chat/build \
  -v $(pwd)/models:/root/open-avatar-chat/models \
  -v $(pwd)/ssl_certs:/root/open-avatar-chat/ssl_certs \
  -v $(pwd)/config:/root/open-avatar-chat/config \
  openavatarchat:latest \
  --config config/chat_with_minicpm.yaml

Updated both README.md (Chinese) and readme_en.md (English).

Original prompt

Step 2: Choose a Configuration
List available configurations:

bash
ls config/
You'll see files like:

chat_with_minicpm.yaml (fully local, good for testing)
chat_with_openai_compatible.yaml (uses cloud APIs)
chat_with_bailian_cosyvoice.yaml (cloud-heavy)
Step 3: Build and Run with Docker
Option A: Use the provided script (easiest)

bash

Make the script executable

chmod +x build_and_run.sh

Build and run (replace with your chosen config)

./build_and_run.sh --config config/chat_with_minicpm.yaml
Option B: Manual Docker commands

bash

Build the Docker image

docker build -t openavatarchat:latest .

Run the container

docker run -d
--name openavatarchat
--gpus all
-p 8282:8282
-v $(pwd)/config:/app/config
openavatarchat:latest
--config config/chat_with_minicpm.yaml

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
open-avatar-chat1	Error			Nov 29, 2025 2:41am