3D modeling automation in your favorite modeling software.
Project description
Table of Contents
- What is CodeToCAD
- Why CodeToCAD
- Getting Started
- Supported Applications
- Working with the software of your choice
- What's next
- For the developers
- Additional resources
- Support us
What is CodeToCAD
CodeToCAD is an open source code-CAD automation. It provides extendable, declarative and imperative interfaces that allow engineers and developers to write code-CAD scripts that can be checked into source control, collaborated on, and run on any supported 3D modeling software.
Why CodeToCAD?
✅ Simplified modeling interface - it's all text! No more scrolling and clicking into sub-menus to edit your models.
🔓 Not vendor locked - your models are created in an open-source language. If you want to use another software, you do not lose the features you have defined. Note: There is no guarantee that a model created for, e.g. Blender, will work right away for another software, but with some refactoring, it theoretically should!
🪶 Lightweight and portable. All you need is a text-editor to model. You can occasionally fire-up your modeling software to run your creations.
💪 Leverages existing programming languages, like Python. You can keep using the languages you're familiar with and love. There is no one-off language you and your team has to learn. Use CodeToCAD like a library or a framework.
🚦Easy version control. Your models are written in code, you can use industry-loved git to keep track of versions of your models.
💕 Built by people who believe in automation and that modeling workflows should be intuitive, reliable and most importantly free and open source!
Getting started
Pre-requisites: Python 3.11 or newer.
-
Install the CodeToCAD PIP Package to get intellisense syntax highlighting.
pip install CodeToCAD
-
Create your own CodeToCAD python file and save it (docs):
# my_codetocad_script.py # More examples can be found under CodeToCAD/examples/ from codetocad import * my_material = Material("material").set_color(169, 76, 181, 0.8) Part("Cube").create_cube(1, 1, 1).set_material(my_material)
-
Watch as your code gets seemlessly translated into CAD using our custom addon for your desired application
- You may also run
codetocad my_codetocad_script.py
from the CLI to run your script.
Above is the above script being run in blender using our Blender Addon below.
Warning: Since CodeToCAD scripts are written and executed in Python, be careful when running scripts you find on the internet!
Supported Applications
Alpha/Beta Support
- Blender 4.0 - Digital Modeling Software
- Fusion 360 - M-CAD, E-CAD and CAE Software developed by Autodesk
- Onshape - Product Development and CAD Software
To Be Developed
- PyBullet - Real-time Physics Simulation Library
- KiCAD - Electronic/PCB Design Software
- LLM/AI based model generation
- FreeCAD - CAD Software
- ThreeJS - Web-based 3D Library
- Libfive - Signed Distance Field Modeling library
Working with the software of your choice
Remember to first follow the getting started instructions
Compatible software
Blender
-
Download a release of the Blender Addon from the latest release
Note for developers: instead of downloading a release, you can clone this repository, then import blender_addon.py and set to CodeToCAD path in the addon to the root of this repository. Please watch this guide to get set up: Video Guide
-
Install the Blender Addon in the blender software
-
Import your script using the file menu > import > CodeToCAD or the CodeToCAD menu in the sidebar.
Note, you can also run CodeToCAD in Blender via cli:
blender -- --codetocad $(pwd)/yourScript.py
orcodetocad yourScript.py blender /path/to/blender/executable
Sidebar Panel
You can use the side-panel to import CodeToCAD files or start a debugger server.
Fusion 360
To use CodeToCAD with Fusion 360, please install the Add-In. Please check out the README for more information.
Onshape
Please refer to the Onshape README for more information on how to setup an API key and connect to the Onshape Client.
What's next
-
Run or browse the examples!
-
Join the Discord Server to receive updates and help from the community!
For the developers
We welcome all contributors to the project, to get started with contributing check out our Contributing guidelines
Additional Resources
Contributors
Thank you to all our contributors for their invaluable time, effort, and expertise in making CodeToCAD possible:
Support us ❤️
Any and all donations toward the project are much appreciated and help greatly:
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file codetocad-0.4.1720759072.tar.gz
.
File metadata
- Download URL: codetocad-0.4.1720759072.tar.gz
- Upload date:
- Size: 43.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.9.19
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0459b12a52fa998415fff6a07569a6608710bf02188ae9446698bc01f373b30e |
|
MD5 | b5b8951384569460e04abef5e0020fd2 |
|
BLAKE2b-256 | 70a0e86ba6c9f4962e443973eba9d95519d4a8a2fbf6b0d7d46463713684889b |