Skip to content

Installation

Jeremy Wright edited this page Apr 28, 2025 · 3 revisions

Contents

Installation (conda/mamba)

Use conda or mamba to install:

mamba install -c cadquery -c conda-forge cq-editor=master

and then simply type cq-editor to run it. This installs the latest version built directly from the HEAD of this repository.

Alternatively clone this git repository and set up the following conda environment:

mamba env create -f cqgui_env.yml -n cqgui
mamba activate cqgui
python run.py

If you are concerned about mamba/conda modifying your shell settings, you can use micromamba:

micromamba install -n base -c cadquery cq-editor
micromamba run -n base cq-editor

On some linux distributions (e.g. Ubuntu 18.04+) it might be necessary to install additonal packages:

sudo apt install libglu1-mesa libgl1-mesa-dri mesa-common-dev libglu1-mesa-dev

On Fedora 29 the packages can be installed as follows:

dnf install -y mesa-libGLU mesa-libGL mesa-libGLU-devel

Installation (pip)

A newer installation option (starting with 0.3.0) is to install via pip. Being a newer option, there may be issues that are not present with the conda installation method. It has worked well in testing so far though.

pip install CQ-editor

Installation (Pre-Built Packages)

Development Packages

Development builds are also available, but can be unstable and should be used at your own risk. You can download the newest build here. Install and run the run.sh (Linux/MacOS) or run.bat (Windows) script in the root CQ-editor directory. The CQ-editor window should launch.

MacOS workarounds

On later MacOS versions you may also need xattr -r -d com.apple.quarantine path/to/CQ-editor-MacOS.

Clone this wiki locally