Skip to content

Commit 762cd7e

Browse files
committed
[release] Release 2.2.0
1 parent d79ba36 commit 762cd7e

68 files changed

Lines changed: 36 additions & 2265 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

README.md

Lines changed: 30 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -1,33 +1,35 @@
1-
[![demo](docs/en/_static/image/teaser.png "demo")](https://www.youtube.com/watch?v=fD0F1jIax5Y)
1+
[![demo](static/teaser.webp "demo")](https://www.youtube.com/watch?v=fD0F1jIax5Y)
22
<div id="top" align="left">
33

44
[![arxiv](https://img.shields.io/badge/arXiv%202407.10943-red?logo=arxiv)](https://arxiv.org/abs/2407.10943)
55
[![pdf](https://img.shields.io/badge/Paper-06AC38?logo=pagekit)](https://github.com/grutopia/grutopia.github.io/releases/download/v0.1.0/GRUtopia.pdf)
6-
[![github](https://img.shields.io/badge/Project-0065D3?logo=rocket&logoColor=white)](https://github.com/OpenRobotLab/GRUtopia)
7-
[![doc](https://img.shields.io/badge/Document-FFA500?logo=readthedocs&logoColor=white)](https://grutopia.github.io)
6+
[![github](https://img.shields.io/badge/Project-0065D3?logo=rocket&logoColor=white)](https://github.com/InternRobotics/InternUtopia)
7+
[![doc](https://img.shields.io/badge/Document-FFA500?logo=readthedocs&logoColor=white)](https://internrobotics.github.io/user_guide/internutopia/)
88
[![video-en](https://img.shields.io/badge/YouTube-D33847?logo=youtube)](https://www.youtube.com/watch?v=fD0F1jIax5Y)
99
[![video-cn](https://img.shields.io/badge/Bilibili-00A1D6?logo=bilibili&logoColor=white)](https://www.bilibili.com/video/BV1JUbxeMEsL/?buvid=XU42709457560E0722A8AA591EE792A3DAE59&from_spmid=search.search-result.0.0&is_story_h5=false&mid=vxiHfNKVdk6fb8fduRusuX8FTQ%2FSZMtL1rElX6M3iMo%3D&p=1&plat_id=116&share_from=ugc&share_medium=android&share_plat=android&share_session_id=e78b4bb6-087b-4a72-817b-b06ef91167f3&share_source=COPY&share_tag=s_i&spmid=united.player-video-detail.0.0&timestamp=1720788955&unique_k=CeKgxGI&up_id=3546722198358311&vd_source=7f685cd616faf836ed7469749c100410)
10-
[![PyPI Downloads](https://static.pepy.tech/badge/grutopia)](https://pepy.tech/projects/grutopia)
11-
[![GitHub Issues](https://img.shields.io/github/issues/OpenRobotLab/GRUtopia)](https://github.com/OpenRobotLab/GRUtopia/issues)
10+
[![PyPI Downloads](https://static.pepy.tech/badge/internutopia)](https://pepy.tech/projects/internutopia)
11+
[![GitHub Issues](https://img.shields.io/github/issues/InternRobotics/InternUtopia)](https://github.com/InternRobotics/InternUtopia/issues)
1212
<a href="https://cdn.vansin.top/taoyuan.jpg"><img src="https://img.shields.io/badge/WeChat-07C160?style=for-the-badge&logo=wechat&logoColor=white" height="20" style="display:inline"></a>
1313
[![Discord](https://img.shields.io/discord/1373946774439591996?logo=discord)](https://discord.gg/5jeaQHUj4B)
1414
</div>
1515

16-
# GRUtopia
16+
# InternUtopia
1717

1818
## 🔥 News
1919

20+
- \[2025-07\] InternUtopia 2.2.0 is released!
21+
- \[2025-07\] Our project has been renamed to InternUtopia.
2022
- \[2025-02\] GRUtopia 2.0 released!
2123
- \[2024-07\] We release the [paper](https://arxiv.org/abs/2407.10943) and demos of GRUtopia.
2224

2325
## 🚀 New Features in 2.0 release
2426
- Gym compatible env implementation.
25-
- Easy-to-use pythonic config system to use out-of-the-box [sensors](https://grutopia.github.io/usage/tutorials/how-to-use-sensor.html), [controllers](https://grutopia.github.io/usage/tutorials/how-to-use-controller.html), [robots](https://grutopia.github.io/usage/tutorials/how-to-use-robot.html) and [tasks](https://grutopia.github.io/usage/tutorials/how-to-use-task.html).
26-
- Examples of driving [diverse robots](https://grutopia.github.io/usage/tutorials/how-to-use-robot.html) and the corresponding policies.
27-
- [Benchmark and baseline](https://grutopia.github.io/usage/get_started/run-benchmark-baseline.html) for social navigation and mobile manipulation task.
28-
- Teleportation tools with [Mocap](https://grutopia.github.io/usage/get_started/teleoperating-with-mocap.html) and [Apple VisionPro](https://grutopia.github.io/usage/get_started/teleoperating-with-visionpro.html).
29-
- Physically accurate [interactive object assets](https://huggingface.co/datasets/OpenRobotLab/GRScenes) that are ready for simulation.
30-
- Procedural [Indoor Scene Generation](https://github.com/OpenRobotLab/GRUtopia/tree/main/toolkits/indoor_scenes_generation) with [GRScenes-100](https://grutopia.github.io/usage/get_started/explore-grscenes.html).
27+
- Easy-to-use pythonic config system to use out-of-the-box [sensors](https://internrobotics.github.io/user_guide/internutopia/tutorials/how-to-use-sensor.html), [controllers](https://internrobotics.github.io/user_guide/internutopia/tutorials/how-to-use-controller.html), [robots](https://internrobotics.github.io/user_guide/internutopia/tutorials/how-to-use-robot.html) and [tasks](https://internrobotics.github.io/user_guide/internutopia/tutorials/how-to-use-task.html).
28+
- Examples of driving [diverse robots](https://internrobotics.github.io/user_guide/internutopia/get_started/drive-unitree-g1-with-keyboard.html) and the corresponding policies.
29+
- Benchmark and baseline for [social navigation](https://internrobotics.github.io/user_guide/internnav/) and [mobile manipulation](https://internrobotics.github.io/user_guide/internmanip/) task.
30+
- Teleportation tools with [Mocap](https://internrobotics.github.io/user_guide/internutopia/get_started/control-franak-with-your-hand.html) and [Apple VisionPro](https://internrobotics.github.io/user_guide/internutopia/get_started/teleoprate-fourier-gr1-with-visionpro.html).
31+
- Physically accurate [interactive object assets](https://huggingface.co/datasets/InternRobotics/GRScenes) that are ready for simulation.
32+
- Procedural [Indoor Scene Generation](https://github.com/InternRobotics/InternUtopia/tree/main/toolkits/indoor_scenes_generation) with [GRScenes-100](https://internrobotics.github.io/user_guide/internutopia/get_started/dive-into-grscenes-100.html).
3133

3234
## 📋 Contents
3335
- [🏠 About](#-about) <!-- omit in toc -->
@@ -47,7 +49,7 @@
4749

4850
Recent works have been exploring the scaling laws in the field of Embodied AI. Given the prohibitive costs of collecting real-world data, we believe the <b>Simulation-to-Real (Sim2Real) paradigm</b> is a more feasible path for scaling the learning of embodied models.
4951

50-
We introduce project <b>GRUtopia</b> (aka. 桃源 in Chinese), a general-purpose research platform for embodied AGI.
52+
We introduce project <b>InternUtopia</b> (aka. 桃源 in Chinese), a general-purpose research platform for embodied AGI.
5153
It features several advancements:
5254
* 🏙️ <b>GRScenes</b>, the scene dataset, includes 100k interactive finely annotated scenes. GRScenes covers 89 diverse scene categories, facilitating deployment of general robots across different scenarios.
5355
* 🧑‍🤝‍🧑 <b>GRResidents</b>, a Large Language Model (LLM) driven Non-Player Character (NPC) system that enables social interaction, task generation, and task assignment, thus simulating <b>social scenarios</b> for embodied AI applications.
@@ -64,7 +66,7 @@ We hope that this work can alleviate the scarcity of high-quality data in this f
6466
### Prerequisites
6567

6668
- Ubuntu 20.04, 22.04
67-
- [NVIDIA Omniverse Isaac Sim 4.2.0](https://docs.omniverse.nvidia.com/isaacsim/latest/installation/install_workstation.html)
69+
- [NVIDIA Omniverse Isaac Sim 4.5.0](https://docs.isaacsim.omniverse.nvidia.com/4.5.0/installation/install_workstation.html)
6870
- Ubuntu 20.04/22.04 Operating System
6971
- NVIDIA GPU (RTX 2070 or higher)
7072
- NVIDIA GPU Driver (recommended version 535.216.01+)
@@ -75,41 +77,41 @@ We hope that this work can alleviate the scarcity of high-quality data in this f
7577

7678
### Installation
7779

78-
We provide the installation guide [here](https://grutopia.github.io/usage/get_started/installation.html). You can install locally or use docker and verify the installation easily.
80+
We provide the installation guide [here](https://internrobotics.github.io/user_guide/internutopia/get_started/installation.html). You can install locally or use docker and verify the installation easily.
7981

8082
### Documentation \& Tutorial
8183

82-
We provide detailed [docs](https://grutopia.github.io) for the basic usage of different modules supported in GRUtopia. Welcome to try and post your suggestions!
84+
We provide detailed [docs](https://internrobotics.github.io/user_guide/internutopia/) for the basic usage of different modules supported in InternUtopia. Welcome to try and post your suggestions!
8385

8486
## 🏙️ Assets
8587

8688
> [!NOTE]
8789
> 📝First of all you **MUST** complete the [User Agreement for GRScenes-100 Dataset Access](https://docs.google.com/forms/d/e/1FAIpQLSccX4pMb57eZbjXpH12Jz6WUBmCfeyc2t0s98k_u4Z-GD3Org/viewform?fbzx=8256642192244696391).
8890
89-
Then you can choose to download all assets (~80GB) or a minimum set (~500MB) to examine installation by running the following script with [GRUtopia](https://grutopia.github.io/usage/get_started/installation.html) installed:
91+
Then you can choose to download all assets (~80GB) or a minimum set (~500MB) to examine installation by running the following script with [InternUtopia](https://internrobotics.github.io/user_guide/internutopia/get_started/installation.html) installed:
9092

9193
```shell
92-
$ python -m grutopia.download_assets
94+
$ python -m internutopia.download_assets
9395
```
94-
The default path to store the downloaded assets is `${PATH/TO/GRUTOPIA/ROOT}/grutopia/assets`. Users have two ways to configure the asset path:
96+
The default path to store the downloaded assets is `${PATH/TO/INTERNUTOPIA/ROOT}/internutopia/assets`. Users have two ways to configure the asset path:
9597

96-
1. Spcecify a custom path during download using `python -m grutopia.download_assets`.
97-
2. Set it later by running `python -m grutopia.set_assets_path` and entering the preferred directory.
98+
1. Spcecify a custom path during download using `python -m internutopia.download_assets`.
99+
2. Set it later by running `python -m internutopia.set_assets_path` and entering the preferred directory.
98100

99101

100102

101103
### GRScenes-100
102-
If you want to separately download the `GRScenes-100` scene assets, you can manually download them from [OpenDataLab](https://openxlab.org.cn/datasets/OpenRobotLab/GRScenes/tree/main/scenes/GRScenes-100), [ModelScope](https://www.modelscope.cn/datasets/Shanghai_AI_Laboratory/GRScenes/files) and [HuggingFace](https://huggingface.co/datasets/OpenRobotLab/GRScenes/tree/main/scenes/GRScenes-100). Please refer to the [instructions](https://huggingface.co/datasets/OpenRobotLab/GRScenes#%F0%9F%93%9A-getting-started) for scene usage.
104+
If you want to separately download the `GRScenes-100` scene assets, you can manually download them from [OpenDataLab](https://openxlab.org.cn/datasets/OpenRobotLab/GRScenes/tree/main/scenes/GRScenes-100), [ModelScope](https://www.modelscope.cn/datasets/Shanghai_AI_Laboratory/GRScenes/files) and [HuggingFace](https://huggingface.co/datasets/InternRobotics/GRScenes/tree/main/scenes/GRScenes-100). Please refer to the [instructions](https://huggingface.co/datasets/InternRobotics/GRScenes#%F0%9F%93%9A-getting-started) for scene usage.
103105

104106
### Robots & Weights
105-
If you want to separately download robots and policy weights, you can manually download the `robot` directory from from [OpenDataLab](https://openxlab.org.cn/datasets/OpenRobotLab/GRScenes/tree/main/robots), [ModelScope](https://www.modelscope.cn/datasets/Shanghai_AI_Laboratory/GRScenes/files) and [HuggingFace](https://huggingface.co/datasets/OpenRobotLab/GRScenes/tree/main/robots) and move it to the root of the asset path.
107+
If you want to separately download robots and policy weights, you can manually download the `robot` directory from from [OpenDataLab](https://openxlab.org.cn/datasets/OpenRobotLab/GRScenes/tree/main/robots), [ModelScope](https://www.modelscope.cn/datasets/Shanghai_AI_Laboratory/GRScenes/files) and [HuggingFace](https://huggingface.co/datasets/InternRobotics/GRScenes/tree/main/robots) and move it to the root of the asset path.
106108

107109
## 📦 Benchmark & Method
108110
<p align="center">
109-
<img src="docs/en/_static/image/benchmark.png" align="center" width="100%">
111+
<img src="static/benchmark.png" align="center" width="100%">
110112
</p>
111113

112-
We preliminarily establish three benchmarks for evaluating the capabilities of embodied agents from different aspects: <b>Object Loco-Navigation</b>, <b>Social Loco-Navigation</b>, and <b>Loco-Manipulation</b>. Please refer to the [documentation](https://grutopia.github.io/usage/get_started/run-benchmark-baseline.html) for running the benchmarks.
114+
We preliminarily establish three benchmarks for evaluating the capabilities of embodied agents from different aspects: <b>Object Loco-Navigation</b>, <b>Social Loco-Navigation</b>, and <b>Loco-Manipulation</b>. Please refer to the [InternNav](https://internrobotics.github.io/user_guide/internnav/) and [InternManip](https://internrobotics.github.io/user_guide/internmanip/) for running the benchmarks.
113115

114116
## 👥 Support
115117

@@ -123,8 +125,8 @@ Join our [WeChat](https://cdn.vansin.top/taoyuan.jpg) support group or [Discord]
123125
- \[x\] Polish APIs and related codes.
124126
- \[x\] Full release and further updates.
125127
- \[x\] Release the baseline methods and benchmark data.
126-
- \[ \] Support multiple episodes.
127-
- \[ \] Vectorized env and batch execution.
128+
- \[x\] Support multiple episodes.
129+
- \[x\] Vectorized env and batch execution.
128130
- \[ \] Training framework.
129131

130132
## 🔗 Citation
@@ -144,7 +146,7 @@ If you find our work helpful, please cite:
144146

145147
## 📄 License
146148

147-
GRUtopia's simulation platform is [MIT licensed](LICENSE). The open-sourced GRScenes are under the <a rel="license" href="http://creativecommons.org/licenses/by-nc-sa/4.0/">Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License </a><a rel="license" href="http://creativecommons.org/licenses/by-nc-sa/4.0/"><img alt="Creative Commons License" style="border-width:0" src="https://i.creativecommons.org/l/by-nc-sa/4.0/80x15.png" /></a>.
149+
InternUtopia's simulation platform is [MIT licensed](LICENSE). The open-sourced GRScenes are under the <a rel="license" href="http://creativecommons.org/licenses/by-nc-sa/4.0/">Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License </a><a rel="license" href="http://creativecommons.org/licenses/by-nc-sa/4.0/"><img alt="Creative Commons License" style="border-width:0" src="https://i.creativecommons.org/l/by-nc-sa/4.0/80x15.png" /></a>.
148150

149151
## 👏 Acknowledgements
150152

docs/Makefile

Lines changed: 0 additions & 20 deletions
This file was deleted.

docs/README.md

Lines changed: 0 additions & 15 deletions
This file was deleted.

docs/en/_static/css/readthedocs.css

Lines changed: 0 additions & 6 deletions
This file was deleted.
-52.9 KB
Binary file not shown.
-479 KB
Binary file not shown.
-41.1 KB
Binary file not shown.
-33.1 KB
Binary file not shown.
-618 KB
Binary file not shown.

docs/en/_static/image/logo.png

-36.2 KB
Binary file not shown.

0 commit comments

Comments
 (0)