Welcome to Qarnot Cloud
Discover our work, our latest news, and tips
to optimize your computation

go to
< Back

Meshroom on Qarnot – documentation

by Ariane Robineau - February 23, 2022 - Documentation
Meshroom on Qarnot – documentation


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


Meshroom versions adapted on Qarnot:

Meshroom version Qarnot profile
2020.1.0 meshroom-2020.1.0
2021.1.0 meshroom-2021.1.0

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 a replica of a 3D-printed Qarnot boiler. 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 case 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

Note: 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-2021.1.0/
  • 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.


Leave a Reply

Your email address will not be published.