On-Robot Agent

On-Robot Agent #

The following section describes how to install and run Meili Agent. In order to install Meili Agent it is necessary to download and install:

Meili agent can be installed directly for:

Steps to Keep Your Integrations Working Correctly with the New Update 4.0.0 #

Important: This section only applies if you already have robots running in Meili FMS before November 2025.

ROS / ROS2 Integration #

  1. Upgrade Meili libraries (meili-ros-lib to 0.3.18 and meili-sdk to 0.8.8):
pip install meili-sdk --upgrade
pip install meili-ros-lib --upgrade
  1. Upgrade meili_agent–> multifloor branch–> Go to your ROS workspace/src/meili_agent
git checkout multifloor

  1. Add map_id in vehicle settings (Map ID tab)

  2. Go to mission page and click button “set initial position” select robot and click in the location where the robot is. System will transmit configured map_id to the Meili-agent

  3. Now you can add more levels in map_files page ( map editor). Every time you add a new map, you need to go to vehicle settings and add the new map_id.

Note: For ROS2 agent multifloor version still not available but you can contact meili team to help out with the configuration

API Integration #

  1. Upgrade Meili libraries (meili-sdk to 0.8.8):
pip install meili-sdk --upgrade
  1. Add map_id in vehicle settings (Map ID tab) → the same map_id must be configured on the integration side.

Contact Meili if you need support to configure it properly.

VDA5050 Integrations #

Add map_id in vehicle settings (Map ID tab) → the same map_id must be configured on the robot side and provided in the state message.

Keep the current version with new URL #

If you are not yet ready to implement the new changes, you can continue using the current app version at the new URL: Meili Robots Legacy This is a replica of the current (10/2025) app.meilirobots environment. In this case, you only need to update the URL, your organizations and teams will remain untouched.

For ROS or API Integrations on app-legacy.meilirobots.com #

In the root folder where the integration is running, locate the .meili folder and open the file cfg.yaml. Replace the last line as follows:

site: https://app.meilirobots.com

with:

site: https://app-legacy.meilirobots.com

For VDA5050 on app-legacy.meilirobots.com #

Use the new broker URL:

mqtt-legacy.meilirobots.com

or

mqtts-legacy.meilirobots.com