Ariane Robineau
Head of 3D
In charge of 3D
HPC platform
Launch compute tasks in a few lines of code or a few clicks on Tasq, our HPC platform.

Meshroom on Qarnot - documentation

February 23, 2022 - Documentation


Meshroom is a free, open-source 3D Reconstruction Software based on AliceVision, a photogrammetry computer vision framework.


Meshroom versions supported on Qarnot:

  • 2019.2.0
  • 2020.1.0
  • 2021.1.0
  • 2023.2.0

To change the version used, just modify constant DOCKER_TAG. By the default, the latest supported version will be used.

If you are interested in another version, please send us an email at

Test Case

In this test case, a 3D model will be built from photos taken of an object. All the steps and the photogrammetry process are explained in an other article



To download the demo folder, create a photogrammetry folder and navigate in it. You can download the example folder here which contains the input photos. The dataset needs to be unzipped before it can be used on Qarnot.

Launching the case

Before starting a calculation with the Python SDK, a few steps are required:

  • Please ensure that you have created a Qarnot account here.
  • Retrieve the authentication token here
  • Install Qarnot’s Python SDK here

In addition to the Python SDK, Qarnot provides C# and Node.js SDKs and a Command Line. Once everything is set up, the following script needs to be used to start the calculation.

Be sure you have copied your authentication token in the script (instead of <<<MY_SECRET_TOKEN>>>) to be able to launch the task on Qarnot.


Please note that the dataset needs to be unzipped before it can be used on Qarnot. Your tree view should look like this:

  • photogrammetry/
    • CuteB3

To launch this script, simply copy the preceding code in a Python script, put it at the same level as the photogrammetry folder and execute python3 in your terminal. 

Note: if you want to add other flags to the Command line sent to the Docker container, you can use the MESHROOM_EXTRA_FLAGS environment variable. It's useful to know that:

  • the Meshroom installation folder is /mehsroom/Meshroom/
  • the Bucket data is located in /job/


At any given time, you can monitor the status of your task on the general web interface Tasq. The following figure shows a successful Meshroom task on Qarnot’s Tasq.

Wrapping up

That’s it! If you have any questions, please contact and we will help you with pleasure! You can read a more detailed article on this use case here : Create your own 3D model with photogrammetry – Qarnot Blog.

Share on networks