Instructions to use Alibaba-DAMO-Academy/RynnWorld-Teleop with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Diffusers
How to use Alibaba-DAMO-Academy/RynnWorld-Teleop with Diffusers:
pip install -U diffusers transformers accelerate
import torch from diffusers import DiffusionPipeline from diffusers.utils import load_image, export_to_video # switch to "mps" for apple devices pipe = DiffusionPipeline.from_pretrained("Alibaba-DAMO-Academy/RynnWorld-Teleop", dtype=torch.bfloat16, device_map="cuda") pipe.to("cuda") prompt = "A man with short gray hair plays a red electric guitar." image = load_image( "https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/diffusers/guitar-man.png" ) output = pipe(image=image, prompt=prompt).frames[0] export_to_video(output, "output.mp4") - Notebooks
- Google Colab
- Kaggle
π« Project Page | π€ Hugging Face | π€ ModelScope | π Video | π arXiv
π Abstract
We introduce RynnWorld-Teleop, a robot-centric generative world model that instantiates the paradigm of digital teleoperationβdecoupling robot data collection from physical hardware constraints. By transforming an operator's real-time hand-pose stream into high-fidelity egocentric robotic videos from a single reference image, RynnWorld-Teleop enables the scaling of expert trajectories in a purely virtual environment. Our framework integrates depth-aware skeletal conditioning with a progressive human-to-robot training curriculum, allowing it to inherit rich manipulation priors from large-scale human datasets. To support interactive use, we distill the model into a causal, autoregressive student capable of real-time streaming. Policies trained exclusively on RynnWorld-Teleop synthetic data achieve effective zero-shot Sim2Real transfer, demonstrating its power as a high-fidelity data engine for scaling dexterous robotic learning.
π° News
- [2026.07.07] π₯π₯ Release our Technical Report !!
- [2026.07.07] π₯π₯ Release our code and model checkpoints!!
π¦ This Repository
This repository hosts the SFT (full fine-tune) checkpoint of RynnWorld-Teleop. Given a first-frame image and a hand-pose / skeleton control video, the model generates a high-fidelity egocentric robotic video.
Model Zoo
π Quick Start
Please refer to the code repository for the full setup, training, and inference pipeline.
π§ Environment Setup
conda create -n "rynnworld-teleop" python=3.10 -y
conda activate rynnworld-teleop
pip3 install torch torchvision --index-url https://download.pytorch.org/whl/cu121
pip install -r requirements.txt
π Download the Checkpoint
Our model is developed on top of Wan2.2-TI2V-5B. Download the base model and place it under pretrained/:
RynnWorld-Teleop/
βββ pretrained/
βββ Wan2.2-TI2V-5B-Diffusers/
βββ model_index.json
βββ scheduler/
βββ transformer/
βββ vae/
βββ ...
Then download our fine-tuned weights:
mkdir -p pretrained/RynnWorld-Teleop
huggingface-cli download Alibaba-DAMO-Academy/RynnWorld-Teleop --local-dir pretrained/RynnWorld-Teleop
π¬ Inference
Given a first-frame image and a control video (hand-pose / OpenPose mp4), the model generates the corresponding egocentric video.
python inference_user.py \
--image <first_frame.png> \
--control_video <control.mp4> \
--output results/my_demo \
--prompt "Describe the action in one sentence." \
--checkpoint <sft_checkpoint_dir> \
--mode sft \
--control_type add \
--seeds "42,123,7"
Required arguments
--image: first-frame image (jpg/png), automatically resized to 832Γ480--control_video: control video mp4 (hand-pose / OpenPose), sampled/interpolated to 81 frames--output: output directory
Useful options
--mode sft|lora: which checkpoint type to load (default:sft)--prompt: optional natural-language description (encoded with the T5 text encoder)--text_embedding: alternative pre-encoded prompt embedding.safetensors--seeds "42,123,7": generate multiple samples in one run--no_ema: use raw weights instead of EMA--guidance_scale: classifier-free guidance scale (default 1.0)--control_type add|concat|add-plus: how the control signal is merged
For real-time streaming inference with the distilled causal student, please see the RynnWorld-Teleop-Causal checkpoint.
ποΈ Training
We train the teacher model in three stages:
- Stage 0 β Pretrain (egocentric human videos): Full-parameter SFT on large-scale egocentric data, no control-video conditioning. Absorbs general manipulation priors.
- Stage 1 β Control-conditioned fine-tuning: Adds a zero-initialized
control_patch_embedding(Conv3d) and a learnablecontrol_scaleto inject hand-pose control video into the diffusion process. LoRA (lightweight) and Full-SFT (best quality) variants are provided. - Distillation β Causal student: Distilled into a causal autoregressive model for real-time streaming.
Full training scripts, configs, and data-preparation instructions are available in the code repository.
π Citation
If you find this project useful, please cite:
@article{rynnworld_teleop,
title = {RynnWorld-Teleop: An Action-Conditioned World Model for Digital Teleoperation},
author = {DAMO Academy, Alibaba Group},
year = {2026},
}
License
Apache License 2.0 β see LICENSE for details.
- Downloads last month
- -
Model tree for Alibaba-DAMO-Academy/RynnWorld-Teleop
Base model
Wan-AI/Wan2.2-TI2V-5B-Diffusers