Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/freecad/freecad

This is the official source code of FreeCAD, a free and opensource multiplatform 3D parametric modeler.
https://github.com/freecad/freecad

3d 3d-printing architecture bim cad coin engineering fem freecad linux mac-osx opencascade windows

Last synced: 7 days ago
JSON representation

This is the official source code of FreeCAD, a free and opensource multiplatform 3D parametric modeler.

Awesome Lists containing this project

README 

        



### Your own 3D parametric modeler



[Website](https://www.freecad.org) •

[Documentation](https://wiki.freecad.org) •

[Forum](https://forum.freecad.org/) •

[Bug tracker](https://github.com/FreeCAD/FreeCAD/issues) •

[Git repository](https://github.com/FreeCAD/FreeCAD) •

[Blog](https://blog.freecad.org)



[![Release](https://img.shields.io/github/release/freecad/freecad.svg)](https://github.com/freecad/freecad/releases/latest) [![Crowdin](https://d322cqt584bo4o.cloudfront.net/freecad/localized.svg)](https://crowdin.com/project/freecad) [![Liberapay](https://img.shields.io/liberapay/receives/FreeCAD.svg?logo=liberapay)](https://liberapay.com/FreeCAD)






Overview

--------



* **Freedom to build what you want**  FreeCAD is an open-source parametric 3D 

modeler made primarily to design real-life objects of any size. 

Parametric modeling allows you to easily modify your design by going back into 

your model history to change its parameters. 



* **Create 3D from 2D and back** FreeCAD lets you to sketch geometry constrained

 2D shapes and use them as a base to build other objects. 

 It contains many components to adjust dimensions or extract design details from 

 3D models to create high quality production-ready drawings.



* **Designed for your needs** FreeCAD is designed to fit a wide range of uses

including product design, mechanical engineering and architecture,

whether you are a hobbyist, programmer, experienced CAD user, student or teacher.



* **Cross platform** FreeCAD runs on Windows, macOS and Linux operating systems.



* **Underlying technology**

    * **OpenCASCADE** A powerful geometry kernel, the most important component of FreeCAD

    * **Coin3D library** Open Inventor-compliant 3D scene representation model

    * **Python** FreeCAD offers a broad Python API

    * **Qt** Graphical user interface built with Qt



Installing

----------



Precompiled packages for stable releases are available for Windows, macOS and Linux on the

[Releases page](https://github.com/FreeCAD/FreeCAD/releases).



On most Linux distributions, FreeCAD is also directly installable from the 

software center application.



For development releases check the [weekly-builds page](https://github.com/FreeCAD/FreeCAD-Bundle/releases/tag/weekly-builds).



Other options are described on the [wiki Download page](https://wiki.freecad.org/Download).



Compiling

---------



Compiling FreeCAD requires the installation of several libraries and their 

development files such as OCCT (Open Cascade), Coin and Qt, listed in the 

pages below. Once this is done, FreeCAD can be compiled with 

CMake. On Windows, these libraries are bundled and offered by the 

FreeCAD team in a convenient package. On Linux, they are usually found 

in your distribution's repositories, and on macOS and other platforms, 

you will usually have to compile them yourself.



The pages below contain up-to-date build instructions:



- [Linux](https://wiki.freecad.org/Compile_on_Linux)

- [Windows](https://wiki.freecad.org/Compile_on_Windows)

- [macOS](https://wiki.freecad.org/Compile_on_MacOS)

- [Cygwin](https://wiki.freecad.org/Compile_on_Cygwin)

- [MinGW](https://wiki.freecad.org/Compile_on_MinGW)



Reporting Issues

---------



To report an issue please:



- Consider posting to the [Forum](https://forum.freecad.org), [Discord](https://discord.com/invite/F4hdxzYZfc) channel, or [Reddit](https://www.reddit.com/r/FreeCAD) to verify the issue; 

- Search the existing [issues](https://github.com/FreeCAD/FreeCAD/issues) for potential duplicates; 

- Use the most updated stable or [development versions](https://github.com/FreeCAD/FreeCAD-Bundle/releases/tag/weekly-builds) of FreeCAD; 

- Post version info from `Help > About FreeCAD > Copy to clipboard`; 

- Restart FreeCAD in safe mode `Help > Restart in safe mode` and try to reproduce the issue again. If the issue is resolved it can be fixed by deleting the FreeCAD config files.

- Start recording a macro `Macro > Macro recording...` and repeat all steps. Stop recording after the issue occurs and upload the saved macro or copy the macro code in the issue; 

- Post a Step-By-Step explanation on how to recreate the issue; 

- Upload an example file (FCStd as ZIP file) to demonstrate the problem; 



For more details see:



- [Bug Tracker](https://github.com/FreeCAD/FreeCAD/issues)

- [Reporting Issues and Requesting Features](https://github.com/FreeCAD/FreeCAD/issues/new/choose)

- [Contributing](https://github.com/FreeCAD/FreeCAD/blob/main/CONTRIBUTING.md)

- [Help Forum](https://forum.freecad.org/viewforum.php?f=3)

- [Developers Handbook](https://freecad.github.io/DevelopersHandbook/)



The [FPA](https://fpa.freecad.org) offers developers the opportunity

to apply for a grant to work on projects of their choosing. Check

[jobs and funding](https://blog.freecad.org/jobs/) to know more.



Usage & Getting help

--------------------



The FreeCAD wiki contains documentation on 

general FreeCAD usage, Python scripting, and development. These 

pages might help you get started:



- [Getting started](https://wiki.freecad.org/Getting_started)

- [Features list](https://wiki.freecad.org/Feature_list)

- [Frequent questions](https://wiki.freecad.org/FAQ/en)

- [Workbenches](https://wiki.freecad.org/Workbenches)

- [Scripting](https://wiki.freecad.org/Power_users_hub)

- [Development](https://wiki.freecad.org/Developer_hub)



The [FreeCAD forum](https://forum.freecad.org) is also a great place

to find help and solve specific problems you might encounter when

learning to use FreeCAD.



This project receives generous infrastructure support from

  

    

   and KiCad Services Corp.