Curated Code Cad ⚙️ 👩🔧
See the web page version
What is Code-CAD?
It's software that allows you to define 3D CAD models with code. It's a niche popular amongst software devs for obvious reasons — it gives you parametric models almost by default and it's easy to maintain and extend models within a team over time when paired with git. The coding nature of it allows teams to build their own abstraction for re-use and quick prototyping. The Cadhub homepage has a good breakdown of the potential of the Code-CAD paradigm. Code-CAD is not to be confused with 3d geometry libraries, Code-CAD instead has opinionated abstractions for quickly developing mechanical parts.
Which one should you use?
I recommend reading through the entire list below to see if one chimes with you and your needs, beyond that I can make the following recommendation and points:
-
My main recommendation is to use one of the packages that wrap OpenCascade (a mature C++ CAD library). Packages that do so are CadQuery, CascadeStudio, DeclaraCAD and pythonOCC. My reasons for recommending these are as follows:
- Most of Code-CAD tools are plagued with a CSG mindset (that is unions, subtractions and intersections of primitive shapes; cubes spheres etc). This is an inherently limited paradigm (one simple example of this is how internal fillets, which are important for reducing stress concentrations in parts, become very difficult). While CadQuery, CascadeStudio, DeclaraCAD and pythonOCC still offer CSG functionality, you're also able to move beyond it with concepts like lofts and sweeps.
- OpenCascade uses a B-rep (boundary representation) kernel, In my opinion, this means you'll be learning a future-proof tool that won't limit the types of applications you can model for, which is likely the case for mesh kernels, which will cause trouble in for some applications like optics and injection moulding.
-
OpenSCAD is tried and true, with lots of examples and tutorials floating around the internet. It also has a very intuitive syntax that many people without prior programming experience have been able to quickly pick up. However, some reasons you might want to look elsewhere are:
- It can be hard to build powerful abstractions since they've rolled their own language. Consequences of this include that it doesn't have a package manager like many modern languages, and the presence of quirks with the language, such as function definitions that aren't ergonomic.
- Performance can start to suffer with complex parts.
- Its mesh-based kernel has limitations if you want to move beyond 3d-printed parts.
-
Check out the birdhouse example, while anecdotal, seeing the same part made with three different tools might help you decide which syntax you like the most.
-
You might want to simply pick a tool based on your language of choice. Clojure, enaml, Go, Haskell, Lisp, Javascript and Python are all represented below.
-
If you want to make 3D art, Curv is specifically trying to hit that niche.
No matter which one is your tool of choice, if you're here and you love Code-CAD and you'll want to checkout Cadhub. Think of it as Codepen crossed with a thing repository, and it's our love letter to the Maker community. Currently, CascadeStudio is the only Code-CAD integration, but we're working on more. Site, repo.
Special mention
OpenScad
The rest of the packages are in alphabetical order, but OpenScad gets a special mention because it's the OG. Many of the projects below were inspired by OpenScad and is the most well-known choice. If you're new to code-cad this is the safest choice. The syntax is easy to pick up and there lots of guides around the internet.
OpenCascade
It's a c++ library that a number the projects below wrap. OpenCascade uses a Boundary representation (B-rep) kernel, which is a powerful way representing solid geometry, this is a point of difference for some many of the other projects that use a polygon mesh.
Contributing
There are a couple of ways you can help:
- Know of a package that we missed? tell us with an issue or open up a PR.
- Contribute a birdhouse design in one of the tools that are missing.
- Do you think we missed an important point for one of the projects, suggest more details.
Here they are:
AngelCAD
AngelCAD aim to do two things:
-
Offer an embedded, but general-purpose scripting language for Constructive Solid Geometry, via AngelScript. This allows for a natural programming style with true variables, user-defined functions and even classes. Programmers should feel at home. See AngelCAD sample scripts.
-
Offer a fast boolean engine, which is powered by Carve is used for this purpose. This means that AngelCAD is generally many times faster than other mesh-based systems.
AngelCAD is capable of running OpenSCAD script for interoperability and has features like text support and DXF import coming soon.
CadHub
- Repo
- Community
Docs- License: GPL-3
- Online editor
A community hub for sharing code-cad projects. Currently integrates with the excellent CascadeStudio. Built and maintained by yours truly.
CadQuery
CadQuery is a Python library that wraps and extends OpenCascade. It has a philosophy of capturing design intent. The API has been designed to be as close as possible to how you’d describe the object to a human. An example of this is its ability to "select" parts of the model's geometry to run operations on, such as the following code that selects only the edges running along the Z-axis and fillets them.
result = cq.Workplane("XY" ).box(3, 3, 0.5).edges("|Z").fillet(0.125)
CascadeStudio
- Repo
Communityrepo says to use github issuesDocs- License: MIT
- Online editor
A javascript wrapper for OpenCascade that runs in the browser. (OpenCascade can run in the browser when compiled to web-assembly). CadHub integrates with CascadeStudio.
Curv
Curv is a programming language for creating art using mathematics. It’s a 2D and 3D geometric modelling tool that supports full colour, animation and 3D printing. It was inspired by OpenScad and shadertoy.
DeclaraCAD
A declarative parametric 3D modelling program built using OpenCASCADE and enaml.
FreeCAD
FreeCad is a more traditional CAD package that supports python scripting, Both for modelling as well as controlling the FreeCAD GUI itself. Not only that it has a built in OpenScad workbench as well as an external CadQuery workbench, making it the best in this list at interoperability. FreeCAD uses OpenCascade under-the-hood.
ImplicitCAD
- Repo
Community- Docs
- License: AGPL-3
- Online editor
Inspired by OpenScad with a very similar language, implemented in Haskell and includes the ability to write definitions in Haskell, instead of just OpenSCAD, and is part of an 'almost stack' of tools including ExplicitCAD (for a GUI), and HSlice (for an STL slicer).
JSCAD
- Repo
- Community
- Docs
- License: MIT
- Online editor
JSCAD (formally know as OpenJSCAD) provides a programmer’s approach to develop 3D models. In particular, this functionality is tuned towards creating precise models for 3D printing.
JSCAD provides the ability to:
- Create and manipulate 3D models, as well as 2D models
- Use JavaScript programming concepts, and libraries
- Save 3D models as STL (and other) formats
JSCAD is available as a:
- Website
- Command line application for backend processing
- User application
- Set of packages (libraries) for building custom applications
JSCAD allows anyone to create 3D (or 2D) designs by combining simple shapes. And any shape can be rotated, moved, scaled, etc. Complex shapes can be saved as parts, which can used later. And the final design can be exported into various standard formats, i.e. STL, DXF, SVG, etc.
libfive
- Repo
- Community (Github Issues)
- Docs
- License: Mozilla Public License 2.0 and GPL-2 or later
Online editor
Libfive is a software library and set of tools for solid modelling, especially suited for parametric and procedural design. Lisp based language, (so (you (((((can expect ) lots of parentheses))))).
pythonOCC
- Repo
Community- Docs
- License: LGPL-3
- Online editor
Python-based, Also uses OpenCascade.
RapCAD
- Repo
CommunityDocs- License: GPL-3
Online editor
Another project inspired by OpenScad. The author considers key differences to be procedural vs functional programming language style, (i.e variables can be modified) and the use of arbitrary precision arithmetic throughout (meaning there are no unexpected double/float rounding errors). There is a handy feature matrix between RapCAD, OpenScad and ImplicitCad.
scad-clj
- Repo
CommunityDocs(No docs but mirrors openscad functions)- License: EPL-1.0
Online editor
OpenSCAD DSL in Clojure. Functions generally mirror OpenSCAD, with a couple of notable exceptions.
scad-hs
- Repo
CommunityDocs(No docs but mirrors openscad functions)- License: BSD-3-Clause License
Online editor
Same author as scad-cji, he likes functional programming languages clearly.
sdfx
Go-based Code-CAD package that uses a signed distance functions (SDFs) kernel. Is capable of doing fillets and chamfering. The repo includes a standard-library.
SolidPython
Python-based library that wraps OpenScad, i.e. it outputs OpenScad code.
Tovero
Tovero is a binding of Libfive to Common Lisp, including a standalone REPL-based viewer. Tovero can be integrated with Clive, a Common Lisp scene graph and 3D GUI, to build more complex modelling applications.
Node editors / other
Not quiet Code-Cad, but they do embody much of the same thought process.
bitbybit
BlocksCAD
Looks to be unmaintained.
- Repo
- Community
- Docs
- License: GPL-3
- Online editor
Dynamo
Dynamo is, quite literally, what you make it. Working with Dynamo may include using the application, either in connection with other Autodesk software or not, engaging a Visual Programming process, or participating in a broad community of users and contributors. Works with FreeCad
Sverchok
Add-on for blender. Sverchok is a powerful parametric tool for architects, allowing geometry to be programmed visually with nodes.