openeuler/videoqna

OPEA Docker镜像文档

镜像概述和主要用途

OPEA（Open Platform for Enterprise AI）官方Docker镜像是基于openEuler构建的开源容器镜像，旨在提供开放、多供应商、稳健且可组合的生成式AI解决方案。该镜像由openEuler CloudNative SIG维护，可免费使用且不受每用户速率限制。

OPEA平台核心定位是构建生成式AI系统的框架，包含可组合的构建模块、架构蓝图及评估体系，而VideoQnA是其关键应用之一，专注于基于用户提示的视频检索功能。

核心功能和特性

OPEA平台核心特性

• 可组合构建块：提供用于构建最先进生成式AI系统的详细框架，包括LLM、数据存储和提示引擎
• 架构蓝图：检索增强型生成式AI组件栈结构和端到端工作流的设计方案
• 评估体系：围绕性能、功能、可信度和企业级就绪度的四步评估框架

VideoQnA功能

• 视频检索管道：基于视频嵌入在Intel VDMS向量数据库中执行向量相似性搜索
• 硬件兼容性：支持在Intel Xeon CPU、Intel Gaudi2和Nvidia GPU上运行
• 长视频支持：处理长格式视频内容
• 时间搜索：支持基于时间维度的视频检索

支持的标签及架构

使用场景和适用范围

• 企业级生成式AI系统构建
• 视频内容智能检索应用（如教育、媒体、安防等领域）
• 需要长视频处理和时间维度搜索的场景
• 多硬件环境下的AI应用部署

使用方法和配置说明

快速部署步骤

1. 设置环境变量
2. 运行Docker Compose
3. 调用VideoQnA服务

1. 设置环境变量

基础环境变量设置：

bash
# 设置主机IP（示例：host_ip="192.168.1.1"）
export host_ip="外部公网IP"
# 设置no_proxy（示例：no_proxy="localhost, 127.0.0.1, 192.168.1.1"）
export no_proxy="你的no_proxy配置"
# 设置Hugging Face API令牌
export HUGGINGFACEHUB_API_TOKEN="你的Hugging Face API令牌"

代理环境配置（如处于代理环境）：

bash
export http_proxy="你的HTTP代理"
export https_proxy="你的HTTPS代理"

其他环境变量： 获取set_env.sh脚本：set_env.sh

在Xeon处理器上执行：

bash
source set_env.sh

2. 运行Docker Compose

获取对应硬件的compose.yml文件：compose.yml

CPU环境示例：

bash
docker compose -f compose.yml up -d

自动拉取Docker镜像：

bash
docker pull openeuler/videoqna:latest
docker pull openeuler/videoqna-ui:latest

3. 调用VideoQnA服务

bash
curl http://${host_ip}:8888/v1/videoqna -H "Content-Type: application/json" -d '{
      "messages": "那个男人在做什么？",
      "stream": "True"
    }'

获取帮助

• openEuler CloudNative SIG
• openEuler社区
• 更多OPEA信息：opea.dev
• OPEA技术文档：https://opea-project.github.io/