Skip to main content

Install Cyclo Manager

Cyclo Manager runs inside Docker containers. The Python package cyclo-manager on PyPI provides the cyclo_manager CLI, which uses Docker images and Compose to bring up and configure the container stack.

info

Cyclo Manager runs on the AI Worker Orin. Install it on the AI Worker Orin.

  1. Connect to the AI Worker Orin via SSH.

Replace SNPR48A0000 with the serial number printed on the back of the robot body.

ssh robotis@ffw-SNPR48A0000.local
  1. Install the Python package cyclo-manager on the AI Worker Orin.
pip install cyclo-manager
  1. Add the CLI to your PATH and create the containers.
export PATH="$HOME/.local/bin:$PATH"
cyclo_manager up
info

After you run cyclo_manager up once to set up the environment, Cyclo Manager keeps running unless you run cyclo_manager down. You do not need to run cyclo_manager up again after powering the robot off and on.

CLI commands

Use the cyclo_manager CLI from your terminal:

cyclo_manager up   # optional: --pull to fetch the latest images from the registry
cyclo_manager down
cyclo_manager update

  • cyclo_manager up:

    • Registers a host-agent systemd service so it always runs.
    • Creates and starts the cyclo_manager (API) and cyclo_manager_ui containers.
    • Creates the docker daemon and novnc-server containers but does not start them yet (start them later when needed).

  • cyclo_manager down:

    • Stops and removes the containers created by cyclo_manager up.
    • Removes the host-agent service from systemd.

  • cyclo_manager update:

    • Upgrades the cyclo-manager package with pip.
    • Stops the running containers and starts new ones with the updated stack.
    • Restarts the host-agent service.

Open the Cyclo Manager Web UI​

Open the Cyclo Manager web UI on port 3000 in your browser.

info

Connect using the robot IP address or the mDNS hostname. Replace SNPR48A0000 with your robot's serial number.

http://192.168.6.2:3000
http://ffw-SNPR48A0000.local:3000

Cyclo Manager App Page

This is the main page of the Cyclo Manager web UI. From here, you can open the Cyclo Manager or Physical AI Tools pages.
Enter the Cyclo Manager.

Click the Cyclo Manager button to open the Cyclo Manager dashboard page. Dashboard Page