You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: source/en/user_guide/internmanip/quick_start/installation.md
+45-65Lines changed: 45 additions & 65 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -35,6 +35,7 @@ InternManip works across most hardware setups.
35
35
Just note the following exceptions:
36
36
-**GenManip Benchmark** must run on **NVIDIA RTX series GPUs** (e.g., RTX 4090).
37
37
- GR00T requires **CUDA 12.4 installed system-wide (not via Conda)**.
38
+
-**Miniconda**.
38
39
39
40
### Overall Requirements
40
41
-**OS:** Ubuntu 20.04/22.04
@@ -308,72 +309,18 @@ Optionally, users can customize the virtual environments directory path by passi
308
309
./install.sh --venv-dir ./my_envs --model
309
310
```
310
311
311
-
### ⚠️ Troubleshooting
312
-
**1. Tips for Slow or Unstable Networks**
313
312
314
-
If you encounter errors such as timeouts or incomplete downloads, especially in network-restricted or low-bandwidth environments, we recommend the following approaches.
315
-
- By default, `uv pip` uses relatively short HTTP timeouts. To extend the timeout, set the following environment variable before installation:
316
-
```bash
317
-
export UV_HTTP_TIMEOUT=600 # Timeout in seconds (10 minutes)
318
-
```
319
-
- To ensure successful installation without network interruptions, you can download some large packages first and then install them locally:
**2. GCC Fails to Compile Due to Missing Dependencies**
327
-
328
-
When compiling C++ components (e.g., `building ManiSkill2_real2sim`), you might encounter errors related to GCC or missing shared libraries. This guide walks you through how to resolve them without root/sudo permissions.
329
-
330
-
- Step 1: Use a modern GCC (recommended ≥ 9.3.0). Older system compilers (e.g., GCC 5.x or 7.x) may not support required C++ standards. It's recommended to switch to GCC 9.3.0 or newer:
> ⚠️ Note: Simply using a newer compiler might not be enough — it may depend on shared libraries that are not available on your system.
336
-
- Step 2: Manually install required libraries. If you encounter errors like: `error while loading shared libraries: libmpc.so.2 (libmpfr.so.1, libgmp.so.3)`. If you do have `sudo` privileges, the easiest way is to install the required libraries system-wide using your system package manager.
337
-
```bash
338
-
sudo apt update
339
-
sudo apt install gcc-9 g++-9
340
-
```
341
-
Or, you need to manually compile and install the following dependencies locally:
Since we install packages via `uv`, if there are network fluctuations causing some packages to fail installing, the process will skip them and still output `✅ install finished`. This does not guarantee that all packages were installed successfully. Therefore, please **check the logs carefully** after installation to see if there are any errors.
- Step 3 (Optional): Fix Missing `.so` Versions. Sometimes you have the correct library version (e.g., `libgmp.so.10`), but GCC expects an older symlink name (e.g., `libgmp.so.3`). You can fix missing library versions with symlinks.
369
-
- Step 4: Export the Library Path. Make sure the compiler can find your locally installed shared libraries:
If you encounter any issues during the installation, please first check the [Troubleshooting](#troubleshooting) section.
320
+
```
374
321
375
322
376
-
## Verification (WIP)
323
+
## Verification
377
324
378
325
You can evaluate the pretrained **GR00t-N1** model on the `Simpler-Env` benchmark using a **client-server** architecture. This requires two separate terminal sessions:
379
326
@@ -382,7 +329,7 @@ You can evaluate the pretrained **GR00t-N1** model on the `Simpler-Env` benchmar
382
329
Activate the environment for the model, and start the policy server:
383
330
```bash
384
331
source .venv/model/bin/activate
385
-
python scripts/eval/start_policy_server.py
332
+
python scripts/eval/start_agent_server.py
386
333
```
387
334
This will start the policy server that listens for observation inputs and sends back action predictions.
388
335
@@ -503,9 +450,42 @@ sudo apt install libvulkan1
503
450
sudo ldconfig
504
451
```
505
452
506
-
### 4. GCC Fails to Compile Due to Missing Dependencies
453
+
### 4. Handling `RuntimeError: vk::PhysicalDevice::createDeviceUnique: ErrorExtensionNotPresent` in SimplerEnv Benchmark
454
+
455
+
456
+
This error is a tricky issue caused by a failed GPU driver installation when running the SimplerEnv benchmark. Many users have reported this problem in the [SimplerEnv GitHub issue #68](https://github.com/simpler-env/SimplerEnv/issues/68).
457
+
458
+
You may try the suggested solutions there, but they do not always work reliably. Therefore, we provide an alternative approach if you can use container images.
459
+
460
+
#### Alternative Solution Using Apptainer Container
461
+
- Install Apptainer on your system if you haven't already.
462
+
- Download a prebuilt container image with SimplerEnv installed from our [Hugging Face repository](https://huggingface.co/InternRobotics/Manishill2/tree/main).
463
+
- Run the evaluation inside the container using a command similar to the following:
Replace path_to_maniskill2.sif with the actual path to the downloaded container image, and path_to_your_python with the Python interpreter you want to use inside the container.
468
+
469
+
470
+
### 5. Failed to Install `pyzmq` When Building Model Dependency
471
+
472
+
473
+
When installing the `model` environment and encountering the following error:
474
+
```bash
475
+
Resolved 162 packages in 4.80s
476
+
× Failed to build `pyzmq==27.0.1`
477
+
├─▶ The build backend returned an error
478
+
╰─▶ Call to `scikit_build_core.build.build_wheel` failed (exit status: 1)
479
+
```
480
+
A recommended approach is to build from source by running:
481
+
```bash
482
+
./install.sh --model_bfs
483
+
```
484
+
If this fails with GCC-related errors, please refer to the troubleshooting advice below.
485
+
486
+
### 6. GCC Fails to Compile Due to Missing Dependencies
507
487
508
-
When compiling C++ components (e.g., `building ManiSkill2_real2sim`), you might encounter errors related to GCC or missing shared libraries. This guide walks you through how to resolve them without root/sudo permissions.
488
+
When compiling C++ components (e.g., `building ManiSkill2_real2sim` or `pyzmq`), you might encounter errors related to GCC or missing shared libraries. This guide walks you through how to resolve them without root/sudo permissions.
509
489
510
490
- Step 1: Use a modern GCC (recommended ≥ 9.3.0). Older system compilers (e.g., GCC 5.x or 7.x) may not support required C++ standards. It's recommended to switch to GCC 9.3.0 or newer:
511
491
```bash
@@ -531,7 +511,7 @@ When compiling C++ components (e.g., `building ManiSkill2_real2sim`), you might
0 commit comments