On-robot agent

In order to connect your robots to Meili FMS, you must install and run Meili Agent on your robots or on a computer/server that can communicate with your robots. The agent is responsible for sending the robot’s state to Meili FMS and receiving commands from Meili FMS to control the robot.

The following section describes how to install and run Meili Agent. Install Meili CLI first, then the agent for your robot type.

VDA5050 integrations do not need to install Meili Agent on the robot. The only requirement is to redirect the robot’s VDA5050 state messages to the Meili FMS broker.

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

This section only applies if you already had 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

2. Upgrade meili_agent–> multifloor branch–> Go to your ROS workspace/src/meili_agent

git checkout multifloor

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

4. 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

5. 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.

The multifloor version of the ROS2 agent is not available yet. Contact the Meili team for help with the configuration.

API Integration

1. Upgrade Meili libraries (meili-sdk to >=0.8.8):

pip install meili-sdk --upgrade

2. 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.