| --- |
| license: other |
| license_name: sam-license |
| license_link: https://huggingface.co/LGG100/linglongimage/blob/main/LICENSE_SAM |
| tags: |
| - docker |
| - robotics |
| - motion-retargeting |
| --- |
| |
| # linglong-live Docker image |
|
|
| Docker image of the monocular RGB → LingLong 2.0 real-time motion retargeting system |
| (OpenLoong 大师赛第一期 · 赛题一 · 复赛), built for **RTX 50xx (Blackwell, sm_120)**: |
| CUDA 12.8 base, torch 2.7.1+cu128. Model weights are bundled. |
| |
| ## Usage |
| |
| Host: Linux, NVIDIA GPU (≥ 8 GB), nvidia-container-toolkit. |
| |
| ```bash |
| hf download LGG100/linglongimage linglong-live.tar --local-dir . |
| docker load -i linglong-live.tar # -> linglong-live:latest |
| |
| # webcam + window |
| xhost +local:root |
| docker run --rm -it --gpus all --ipc=host --network host --device /dev/video0 \ |
| -e DISPLAY=$DISPLAY -v /tmp/.X11-unix:/tmp/.X11-unix \ |
| -v linglong_cache:/cache -v $PWD/out:/out linglong-live --source 0 |
| |
| # headless, video file |
| docker run --rm --gpus all --ipc=host -v linglong_cache:/cache -v $PWD/out:/out \ |
| -v $PWD/input.mp4:/in.mp4:ro linglong-live --source /in.mp4 --headless \ |
| --record /out/out.mp4 --log /out/log.csv |
| ``` |
| |
| The first frame compiles GPU kernels (cached in the `linglong_cache` volume). |
| |
| ## Bundled third-party materials |
| |
| - **SAM 3D Body weights** (`facebook/sam-3d-body-dinov3`), redistributed under the SAM License — see `LICENSE_SAM`. |
| - **YOLO11m-pose** (Ultralytics), AGPL-3.0. |
| - **MoGe-2 ViT-S** (`Ruicheng/moge-2-vits-normal`). |
| - **LingLong 2.0 URDF and meshes** (official competition release, unmodified). |
|
|
