This guide explains how to deploy the Youtu-agent service with its frontend using Docker.

• Docker installed on your system
  • Visit https://www.docker.com/ to download and install Docker if needed
  • Verify your installation by running docker --version

Execute the command below to clone the project repository:

git clone https://github.com/Tencent/youtu-agent.git

Build the Youtu-agent Docker image.

Note: The Dockerfile is located in the docker/ directory.

cd youtu-agent/docker docker build -t youtu-agent .

1. Create a configuration file by copying the template:

cp .env.docker.example .env

2. Configure the following required variables in .env:

# LLM Configuration (required) UTU_LLM_TYPE=chat.completions UTU_LLM_MODEL=deepseek-chat UTU_LLM_BASE_URL=https://api.deepseek.com/v1 UTU_LLM_API_KEY=<your-api-key> # Required # Serper API Configuration # Get your key from https://serper.dev/playground SERPER_API_KEY=<your-serper-key> # Frontend Configuration # Note: IP must be 0.0.0.0 for Docker container port forwarding UTU_WEBUI_PORT=8848 UTU_WEBUI_IP=0.0.0.0 

Replace /path/to/your/.env with the actual path to your .env file, then run:

docker run -it \ -p 8848:8848 \ -v "/path/to/your/.env:/youtu-agent/.env" \ youtu-agent

The service will be accessible at http://127.0.0.1:8848

To run other examples or custom configurations by replacing the /path/to/your/.env:

docker run -it \ -p 8848:8848 \ -v "/path/to/your/.env:/youtu-agent/.env" \ youtu-agent \ bash