Build from Source

For developers or users who want the latest features, you can build Zeo from source.

Prerequisites

  • Git
  • CMake 3.21 or later
  • C++20 compiler (GCC 11+, Clang 14+, or MSVC 2022)
  • Python 3.9 or later

macOS

Install build dependencies via Homebrew:

brew install automake libtool bison opencascade swig glew glm boost harfbuzz cairo doxygen gettext wget libgit2 openssl unixodbc ninja protobuf nng zstd libomp

Linux

See your distribution's package manager for equivalent packages.

Clone the Workspace

Zeo uses a multi-repo workspace. Clone the dev repo and use the sync script to fetch everything:

mkdir zeo && cd zeo
git clone https://github.com/zeodotdev/dev.git
./dev/sync.sh

Build Steps

macOS

# Full build (first time)
./dev/mac_build_hard.sh

# Incremental build (after first build)
./dev/mac_build_fast.sh

Linux

# Full build
./dev/linux_build_fast.sh

Windows

# Build via PowerShell
.\dev\win_build_fast.ps1

Launching

After a successful build, use the --launch flag to open the app:

./dev/mac_build_fast.sh --launch