unrealcv

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

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署计算机视觉 🍴 复刻 464 🐛 待处理 118 👀 关注 83

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 2225

维护状态维护中

是否开源开源

定价模式 🏷️完全免费开源项目，MIT许可证，完全免费，无付费版本。

项目预览

项目数据

分类计算机视觉

开发团队unrealcv

官网地址https://unrealcv.org

GitHubhttps://github.com/unrealcv/unrealcv

定价模式🏷️完全免费

价格说明开源项目，MIT许可证，完全免费，无付费版本。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言Python

技术栈/模型computer-vision,embodied-ai,machine-learning,simulation,synthetic-data,ue4,ue5,virtual-worlds

GitHub 星标★ 2225

上线时间2016-09-08 00:00:00

代码更新2026-09-04

仓库体积20.6 MB

本站数据更新2026-11-09

维护状态维护中

收录时间2026-08-10

浏览次数8

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-10 · 当前星标 ★ 2225

技术标签

computer-vision embodied-ai machine-learning simulation synthetic-data

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

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

环境要求

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

安装与启动步骤

1下载 UnrealCV 源码

从 GitHub 克隆 UnrealCV 仓库到本地，稍后会放入 UE 项目的 Plugins 目录。
```
git clone https://github.com/unrealcv/unrealcv.git
```
2放入 Plugins 目录

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

用 Visual Studio 打开并启动该 C++ 项目，UnrealCV 插件会随项目一同编译；注意 VS 版本需与 UE 版本兼容。
4安装 Python 客户端

UnrealCV 客户端是一个 Python 包，直接 pip 安装即可，用于和运行中的 Server 通信。
```
pip install unrealcv
```
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）。