Skip to main content

Cyclo Lab

Cyclo Lab is the Isaac Lab-based environment for training AI Sapiens K1 policies in simulation. It provides the training and export workflow needed before deploying a policy with Sim2Real.

This guide is based on Cyclo Lab 3.0.0.

For robot-side deployment after training, use the Sim2Real guide.

Choose a Physics Backend​

Cyclo Lab provides two physics backends, selected at runtime.

BackendArgumentRuntime
Newton (Default for K1)physics=newton_mjwarpIsaac Sim 6.2.0, Isaac Lab 3.0.0
PhysXphysics=isaacsim_physxIsaac Sim 6.2.0, Isaac Lab 3.0.0

Set Up the Docker Container​

Run Cyclo Lab inside the provided Docker container. The container includes Isaac Sim, Isaac Lab, Cyclo Lab, and the Python dependencies used by the training scripts.

Install these on the host PC first:

  • Docker and Docker Compose.
  • NVIDIA Container Toolkit.
  • NVIDIA GPU driver compatible with the Isaac Sim container image.

Clone Cyclo Lab with its submodules:

git clone https://github.com/ROBOTIS-GIT/cyclo_lab.git
cd cyclo_lab
git submodule update --init
Already cloned Cyclo Lab?

Initialize the submodules before starting the container:

git submodule update --init

Build, start, and enter the container:

./docker/container.sh build
./docker/container.sh start
./docker/container.sh enter

Inside the container, the repository is mounted at:

/workspace/cyclo_lab

Useful host-side commands:

CommandUse
./docker/container.sh buildBuild the image.
./docker/container.sh startInitialize submodules and start the container.
./docker/container.sh recreateRecreate the container after rebuilding the image.
./docker/container.sh enterOpen a shell inside the running container.
./docker/container.sh stopStop the container.
./docker/container.sh logsFollow container logs.
./docker/container.sh cleanRemove the container and image.
note

After rebuilding, use recreate to apply the new image to an existing container. The start script enables X11 forwarding when DISPLAY and xauth are available on the host. Use the no-window option shown for your backend in the training guides when visualization is not required.

Next Steps​