unrealcv

在虚幻引擎里一键生成带标注的视觉数据,省去真实采集成本

UnrealCV 是一个将计算机视觉与虚幻引擎(UE4/UE5)连接起来的开源工具,旨在为视觉研究提供高保真的虚拟世界数据生成平台。它解决了真实数据采集成本高、标注困难、场景不可控等问题,让研究者可以在逼真的3D环境中生成合成图像、深度图、法线图、物体分割掩码等标注数据,并支持通过简单的API控制虚拟相机、物体位置和场景属性。其核心能力包括:提供Unreal Engine插件和Python客户端,支持多种视觉任务的数据生成,如目标检测、语义分割、深度估计、视觉导航等;同时支持与强化学习环境交互,用于具身智能和机器人仿真。UnrealCV降低了虚拟数据生成的门槛,使研究者无需深入游戏开发即可利用虚幻引擎的渲染能力,加速了计算机视觉模型的训练和评估。

开源 free 计算机视觉
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 2215
维护状态 较活跃
是否开源 是
定价模式 free

项目数据

分类计算机视觉
开发团队unrealcv
所属国家
定价模式free
价格说明开源项目,MIT许可证,完全免费,无付费版本。
访问状态
是否开源是
开源协议MIT
主要语言Python
技术栈/模型computer-vision,embodied-ai,machine-learning,simulation,synthetic-data,ue4,ue5,virtual-worlds
GitHub 星标★ 2215
30天Star增速
HF 下载量
上线时间2016-09-08 00:00:00
最近更新2026-09-21 00:00:00
维护状态较活跃
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-10
浏览次数7

使用教程

难度:进阶 约 30 分钟 部署方式:本地安装 5 步

环境要求

  • Unreal Engine 5.2 或更高版本(UnrealCV 已支持 UE5.2+)
  • 一个 C++ 类型的 UE 项目(源码需放入其 Plugins 目录)
  • 与所用 UE 版本兼容的 Visual Studio
  • 已安装 Python 与 pip(用于安装客户端)

安装与启动步骤

  1. 1下载 UnrealCV 源码

    从 GitHub 克隆 UnrealCV 仓库到本地,稍后会放入 UE 项目的 Plugins 目录。

    git clone https://github.com/unrealcv/unrealcv.git
  2. 2放入 Plugins 目录

    把下载的 UnrealCV 源码放到你的 C++ UE 项目的 Plugins 文件夹中,蓝图项目不支持。

  3. 3编译插件

    用 Visual Studio 打开并启动该 C++ 项目,UnrealCV 插件会随项目一同编译;注意 VS 版本需与 UE 版本兼容。

  4. 4安装 Python 客户端

    UnrealCV 客户端是一个 Python 包,直接 pip 安装即可,用于和运行中的 Server 通信。

    pip install unrealcv
  5. 5验证安装

    在 UE 编辑器中按反引号键打开控制台,输入状态查询命令确认插件已生效。

    vget /unrealcv/status

如何确认成功

在 UE 控制台(按 ` 键呼出)执行 vget /unrealcv/status,能返回 UnrealCV 状态信息即安装成功。

常见问题

Q:不想编译 UE 项目能用 UnrealCV 吗?

A:可以。README 说明可直接使用已嵌入 UnrealCV 的编译好的游戏二进制,像运行普通游戏一样使用,无需了解 Unreal Engine;更多预编译二进制见 UnrealZoo 网站。

Q:Visual Studio 版本有什么要求?

A:需与你使用的 UE 版本兼容,具体对应关系参见 Epic 官方关于 UE C++ 开发环境的文档。

Q:Python 客户端怎么装?

A:执行 pip install unrealcv 即可安装 UnrealCV Client。

Q:支持哪些 Unreal Engine 版本?

A:新版特性说明中列出支持 Unreal Engine 5.2 及更高版本。

注意事项

  • UnrealCV 有两种用法:用已嵌入插件的编译后游戏二进制(简单,无需 UE 知识),或把插件装进 UE 编辑器自建虚拟世界。
  • 插件安装面向 C++ UE 项目,源码必须放在项目的 Plugins 目录下。
  • 客户端与 Server 是两个部分,pip install unrealcv 只装客户端,仍需有运行中的 UnrealCV Server。
  • 官方入门教程见 Tutorial: Getting Started(http://unrealcv.github.io/tutorial/getting_started.html)。

核心亮点

  • 基于虚幻引擎,渲染质量高,场景逼真,数据多样性好
  • 提供Python API和插件,上手快,支持常见视觉任务数据生成
  • 支持UE4和UE5,兼容性好,社区有示例和文档

不足之处

  • 安装配置复杂,需要编译插件,对新手不友好
  • 文档更新滞后,部分功能依赖特定引擎版本
  • 社区活跃度一般,问题响应可能较慢

适用场景

  • 合成数据生成:训练目标检测、语义分割模型
  • 具身智能仿真:在虚拟环境中测试导航和操控算法
  • 视觉算法评估:在可控场景下进行基准测试

替代项目

BlenderProc、NVIDIA Isaac Sim、Three.js (用于简单合成数据)

项目介绍

unrealcv 是计算机视觉领域的开源项目,由 unrealcv 开发,2016 年首次发布。

在全站 13,090 个收录项目中,它的 GitHub 星标数(2,215)位列前 30%,在计算机视觉分类中处于中上游。

项目保持着较活跃的维护节奏,最近一次代码更新于 2026-09-21。MIT许可证,完全免费,无付费版本。

它主要面向的使用场景是:合成数据生成:训练目标检测、语义分割模型。同类可对比的替代方案包括 BlenderProc、NVIDIA Isaac Sim、Three.js (用于简单合成数据)。

同类项目推荐

modlens 开源

给纯文本编码代理装上眼睛,粘贴图片即刻获得结构化视觉证据。

The first vision plugin for DeepSeek Harness, and the vision bridge for every text-o···

★ 4019 2026-08-19
opencv 开源

开箱即用的视觉算法库,搞定图像视频处理与识别

Open Source Computer Vision Library

★ 90930 2026-08-10
OpenCVTutorials 开源

中文 OpenCV 教程,从入门到实战,边看边跑代码

OpenCV-Python4.1 中文文档

★ 1430 2026-08-20
DEIMv2 开源

用DINOv3做实时检测,又快又准,直接落地。

[DEIMv2] Real Time Object Detection Meets DINOv3

★ 2046 2026-08-14