Skip to content

CLI Reference

Automate the same offline pipeline as the desktop GUI with the Terapetra CLI — no cloud, no web API.

Commands

mapfree run <images> -o <output>
Run full pipeline on an image folder
-q, --quality {low|medium|high}
Quality preset balancing speed vs detail
--log-level INFO
Structured logging per pipeline stage
mapfree --help
Full CLI help and subcommands

Examples

Standard batch run

mapfree run ./flight01 -o ./project_out -q medium --log-level INFO

Same stages as the GUI: sparse → dense → mesh → geospatial → export

High quality survey

mapfree run ./images -o ./survey -q high --log-level INFO

Requires sufficient RAM and NVIDIA CUDA for dense reconstruction

YAML configuration

Reproducible runs use YAML presets under `terapetra/config/` in the Terapetra install. See quality presets documentation for resolution tiers and VRAM gates.

Quality presets (documentation)

Verify release checksums

  1. Open the release notes page for your Terapetra version on this website.
  2. Find SHA256 checksums in the checksum table for that version.
  3. On Windows: CertUtil -hashfile <installer-filename> SHA256 (use the exact name from the checksum table)
  4. On Linux: sha256sum <appimage-filename> (use the exact name from the checksum table)
  5. Compare the output with the published checksum before installing.

Release notes →

Release notes

Version history, checksums, and installer links on this website.

Release notes Documentation Windows installer