2015-11-28 21:05:20 -05:00
|
|
|
.. _installation:
|
|
|
|
|
|
|
|
|
|
Installing CadQuery
|
|
|
|
|
===================================
|
|
|
|
|
|
|
|
|
|
CadQuery is based on `FreeCAD <http://sourceforge.net/apps/mediawiki/free-cad/index.php?title=Main_Page>`_,
|
|
|
|
|
which is turn based on the open-source `OpenCascade <http://www.opencascade.com/>`_ modelling kernel.
|
|
|
|
|
|
|
|
|
|
Prerequisites--FreeCAD and Python 2.6 or 2.7
|
|
|
|
|
----------------------------------------------
|
|
|
|
|
CadQuery requires FreeCAD and Python version 2.6.x or 2.7.x *Python 3.x is NOT supported*
|
|
|
|
|
|
|
|
|
|
Ubuntu Command Line Installation
|
|
|
|
|
------------------------------------------
|
|
|
|
|
|
|
|
|
|
On Ubuntu, you can type::
|
|
|
|
|
|
|
|
|
|
sudo apt-get install -y freecad freecad-doc
|
|
|
|
|
pip install cadquery
|
|
|
|
|
|
2015-12-01 22:54:36 -05:00
|
|
|
This `Unix Installation Video <http://youtu.be/InZu8jgaYCA>`_ will walk you through the installation
|
|
|
|
|
|
|
|
|
|
|
2015-11-28 21:05:20 -05:00
|
|
|
Installation: Other Platforms
|
|
|
|
|
------------------------------------------
|
|
|
|
|
|
|
|
|
|
1. Install FreeCAD using the appropriate installer for your platform, on `www.freecadweb.org <http://www.freecadweb.org/wiki/?title=Download>`_
|
|
|
|
|
2. pip install cadquery
|
|
|
|
|
|
2015-12-01 22:54:36 -05:00
|
|
|
This `Windows Installation video <https://www.youtube.com/watch?v=dWw4Y_ah-8k>`_ will walk you through the installation on Windows
|
2015-11-28 21:05:20 -05:00
|
|
|
|
|
|
|
|
Test Your Installation
|
|
|
|
|
------------------------
|
|
|
|
|
|
|
|
|
|
If all has gone well, you can open a command line/prompt, and type::
|
|
|
|
|
|
|
|
|
|
$python
|
|
|
|
|
$import cadquery
|
|
|
|
|
$cadquery.Workplane('XY').box(1,2,3).toSvg()
|
|
|
|
|
|
|
|
|
|
Adding a Nicer GUI via the cadquery-freecad-module
|
|
|
|
|
--------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
If you prefer to have a GUI available, your best option is to use
|
2015-12-12 15:08:38 -05:00
|
|
|
`The CadQuery Freecad Module <https://github.com/jmwright/cadquery-freecad-module>`_.
|
2015-11-28 21:05:20 -05:00
|
|
|
|
|
|
|
|
Simply extract cadquery-freecad-module into your FreeCAD installation. You'll end up
|
|
|
|
|
with a cadquery workbench that allows you to interactively run scripts, and then see the results in the FreeCAD GUI
|
|
|
|
|
|
2015-12-12 15:08:38 -05:00
|
|
|
If you are using Ubuntu, you can also install it via this ppa:
|
|
|
|
|
|
|
|
|
|
https://code.launchpad.net/~freecad-community/+archive/ubuntu/ppa/+packages
|
|
|
|
|
|
|
|
|
|
|
2015-11-28 21:05:20 -05:00
|
|
|
Zero Step Install
|
|
|
|
|
-------------------------------------------------
|
|
|
|
|
|
|
|
|
|
If you would like to use cadquery with no installation all, you can
|
2015-12-12 15:08:38 -05:00
|
|
|
use `ParametricParts.com <https://www.parametricparts.com>`_, a web-based platform that runs cadquery scripts
|
2015-11-28 21:05:20 -05:00
|
|
|
|
|
|
|
|
It is free, and allows running and viewing cadquery scripts in your web browser or mobile phone
|
|
|
|
|
|
|
|
|
|
|
