Files
AI-VideoAssistant/docker
Xin Wang 530d95eea4 Enhance Docker configuration and update dependencies for Realtime Agent Studio
- Updated Dockerfile for the API to include build tools for C++11 required for native extensions.
- Revised requirements.txt to upgrade several dependencies, including FastAPI and SQLAlchemy.
- Expanded docker-compose.yml to add MinIO service for S3-compatible storage and improved health checks for backend and engine services.
- Enhanced README.md in the Docker directory to provide detailed service descriptions and quick start instructions.
- Updated mkdocs.yml to reflect new navigation structure and added deployment overview documentation.
- Introduced new Dockerfiles for the engine and web services, including development configurations for hot reloading.
2026-03-04 10:01:00 +08:00
..

Docker Deployment

This folder contains Docker Compose configuration to run the entire AI VideoAssistant stack.

Services

Service Port Description
minio 9000, 9001 S3-compatible object storage
backend 8100 FastAPI backend API
engine 8001 Conversation engine (WebSocket)
frontend 6000 React web application

Prerequisites

  1. Docker and Docker Compose installed
  2. The engine/data/vad/silero_vad.onnx VAD model file must exist
  3. Agent configuration in engine/config/agents/default.yaml

Quick Start

cd docker
docker compose up -d

Access Points

Configuration

Engine Environment Variables

The engine service uses environment variables for configuration. Key variables:

  • BACKEND_URL: Backend API URL (default: http://backend:8100)
  • LOG_LEVEL: Logging level (default: INFO)
  • CORS_ORIGINS: Allowed CORS origins

Agent-specific settings (LLM, TTS, ASR) are configured via YAML files in engine/config/agents/.

Volumes

  • minio_data: MinIO storage data
  • backend_data: Backend SQLite database
  • engine_logs: Engine log files

Development Mode

To mount source code for hot-reload during development:

docker compose -f docker-compose.yml -f docker-compose.dev.yml up -d

Logs

# View all logs
docker compose logs -f

# View specific service logs
docker compose logs -f engine
docker compose logs -f backend

Stopping

docker compose down

# Remove volumes as well
docker compose down -v