Skip to content

Latest commit

 

History

History
60 lines (48 loc) · 2.7 KB

installation.md

File metadata and controls

60 lines (48 loc) · 2.7 KB
Raw

<Back to Main

Installation

Table of Contents

Automated

If you are running FreeCAD 0.17 or newer, which is recommended, this module is easy to install through the included addon manager.

  1. Run the FreeCAD Addon Manager by clicking Tools->Addon manager Addon manager menu item
  2. Scroll down and click on cadquery_module cadquery_module addon item
  3. Click the Install / update button
  4. Restart FreeCAD
  5. Confirm that CadQuery is in the drop down menu of available workbenches

cadquery workbench item

This process can be repeated to update the module every time changes are pushed to the master branch on GitHub.

Manual

Sometimes a different version or branch of the workbench may be needed, other than what is installed using the addon manager. The steps below outline

  1. Download the latest released version
  2. Extract the archive file
  3. Copy the entire extracted directory to FreeCAD's Mod directory on your system. Typical Mod directory locations are listed below.

Linux Mod Locations

  • /usr/lib/freecad/Mod
  • /usr/local/lib/freecad/Mod
  • ~/.FreeCAD/Mod

Windows Mod Locations

  • C:\Program Files\FreeCAD 0.14\Mod
  • C:\Program Files (x86)\FreeCAD 0.14\Mod
  • C:\Users[your_user_name]\Application Data\FreeCAD\Mod

Mac Mod Locations

  • /Applications/FreeCAD.app/Contents/Mod
  • /Applications/FreeCAD.app/Mod
  • /Users/[your_user_name]/Library/Preferences/FreeCAD/Mod
  • ~/Library/Preferences/FreeCAD/Mod

Troubleshooting

You may get a No module named QtNetwork error on Ubuntu based systems when you select the module in FreeCAD. If you do, run the following command line from a terminal to fix this issue.

sudo apt-get install python-pyside.qtnetwork

When running on Ubuntu 14.04 with the default version of FreeCAD included in the repositories, you may get a No module named PySide or No module named QtGui error. If you do, run the following line to install the missing packages.

sudo apt-get install libboost-python1.54.0 libnglib-4.9.13 liboce-foundation10 liboce-modeling10 liboce-ocaf-lite10 liboce-ocaf10 liboce-visualization10 libpyside1.2 libshiboken1.2 python-pyside.qtcore python-pyside.qtgui python-pyside.qtsvg python-pyside.qtuitools python-pyside.qtxml

Next Steps

Once the workbench is installed, the next step is to read through the usage instructions.

<Back to Main