Conda (or Miniconda) is the only prerequisite on all platforms. The conda environment installs the full toolchain — the C++ compiler (MSVC on Windows, clang/gcc elsewhere), CMake, Ninja, and all library dependencies.
The build also needs the bundled
pybind11git submodule. The--recursiveclone below fetches it; in an existing clone rungit submodule update --init --recursive.
git clone --recursive https://github.com/OpenSfM/OpenSfM
cd OpenSfM
conda create --name opensfm --file conda-linux-64.lock --yes
conda activate opensfm
pip install -e .git clone --recursive https://github.com/OpenSfM/OpenSfM
cd OpenSfM
conda create --name opensfm --file conda-osx-arm64.lock --yes
conda activate opensfm
pip install -e .Only Apple Silicon (
arm64) is supported. Intel Macs (osx-64) are not supported — there is no lock file for them.
Install Miniconda first, then run from the Anaconda Prompt:
git clone --recursive https://github.com/OpenSfM/OpenSfM
cd OpenSfM
conda create --name opensfm --file conda-win-64.lock --yes
conda activate opensfm
pip install -e .The MSVC C++ compiler ships with the environment (
conda-win-64.lockpinsvs2022_win-64), so a separate Visual Studio / Build Tools install is not required.
Activate the environment, then run the desired pipeline step:
Linux / macOS:
conda activate opensfm
./bin/opensfm COMMAND path/to/datasetWindows:
conda activate opensfm
bin\opensfm.bat COMMAND path\to\datasetSee using.md for the full list of available commands.
A web-based 3D viewer is included under viewer/. See the quickstart and viewer/README.md for how to serve a dataset.
Example Dockerfiles are provided for Ubuntu 20.04 and 24.04:
docker build -t opensfm.ubuntu24 -f Dockerfile.ubuntu24 .