Name Date Size

..27-Apr.-20224 KiB

.circleci/H02-Sep.-20194 KiB

.clang-formatH A D22-Jun.-20221.9 KiB

.git-blame-ignore-revsH A D26-Apr.-20222.3 KiB

.gitattributesH A D02-Sep.-2019621

.github/H24-May-20224 KiB

.gitignoreH A D10-Jun.-2022537

.log_errorsH A D02-Sep.-201928

.travis/H02-Sep.-20194 KiB

.travis.ymlH A D27-Mar.-202116.8 KiB

appveyor.ymlH A D02-Sep.-20191.9 KiB

BUILD_OSX.mdH A D10-Oct.-202115.1 KiB

build_unix_dev_conda.shH A D27-Sep.-20202.5 KiB

ChangeLog.txtH A D02-Sep.-201951.3 KiB

ci/H21-Sep.-20214 KiB

cMake/H22-Jun.-20224 KiB

CMakeLists.txtH A D19-Jun.-20222.8 KiB

CODE_OF_CONDUCT.mdH A D02-Sep.-20193.9 KiB

conda/H06-Dec.-20214 KiB

config.h.cmakeH A D09-Nov.-20214.4 KiB

data/H02-Sep.-20194 KiB

environment-linux.ymlH A D03-Sep.-2020837

environment-osx.ymlH A D03-Sep.-2020859

lgtm.ymlH A DToday2.2 KiB

LibraryVersions.h.cmakeH A D31-Mar.-20221.4 KiB

LICENSEH A D02-Sep.-201925.2 KiB

package/H06-Mar.-20204 KiB

README.mdH A D16-Jun.-20226.2 KiB

requirements.txtH A D26-Feb.-202294

rpkg.macrosH A D01-Feb.-2022228

SMESH_Version.h.cmakeH A D02-Sep.-2019370

src/H24-Jun.-20224 KiB

tools/build/H01-Aug.-20214 KiB

vagrant/H14-Apr.-20214 KiB

README.md

1![Logo](https://www.freecadweb.org/images/logo.png)
2
3### Your own 3D parametric modeler
4
5[Website](https://www.freecadweb.org) ��� 
6[Documentation](https://wiki.freecadweb.org) ���
7[Forum](https://forum.freecadweb.org/) ���
8[Bug tracker](https://www.freecadweb.org/tracker/) ���
9[Git repository](https://github.com/FreeCAD/FreeCAD)
10
11
12[![Release](https://img.shields.io/github/release/freecad/freecad.svg)](https://github.com/freecad/freecad/releases/latest) [![Master][freecad-master-status]][gitlab-branch-master] [![Crowdin](https://d322cqt584bo4o.cloudfront.net/freecad/localized.svg)](https://crowdin.com/project/freecad) [![Gitter](https://img.shields.io/gitter/room/freecad/freecad.svg)](https://gitter.im/freecad/freecad?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) [![Language grade: Python](https://img.shields.io/lgtm/grade/python/g/FreeCAD/FreeCAD.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/FreeCAD/FreeCAD/context:python) [![Language grade: C/C++](https://img.shields.io/lgtm/grade/cpp/g/FreeCAD/FreeCAD.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/FreeCAD/FreeCAD/context:cpp) [![Liberapay](https://img.shields.io/liberapay/receives/FreeCAD.svg?logo=liberapay)](https://liberapay.com/FreeCAD)
13
14<img src="https://user-images.githubusercontent.com/1828501/174066870-1692005b-f8d7-43fb-a289-6d2f07f73d7f.png" width="800"/>
15
16Overview
17--------
18
19* **Freedom to build what you want**  FreeCAD is an open-source parametric 3D 
20modeler made primarily to design real-life objects of any size. 
21Parametric modeling allows you to easily modify your design by going back into 
22your model history to change its parameters. 
23
24* **Create 3D from 2D and back** FreeCAD lets you to sketch geometry constrained
25 2D shapes and use them as a base to build other objects. 
26 It contains many components to adjust dimensions or extract design details from 
27 3D models to create high quality production-ready drawings.
28
29* **Designed for your needs** FreeCAD is designed to fit a wide range of uses
30including product design, mechanical engineering and architecture,
31whether you are a hobbyist, programmer, experienced CAD user, student or teacher.
32
33* **Cross platform** FreeCAD runs on Windows, macOS and Linux operating systems.
34
35* **Underlying technology**
36    * **OpenCASCADE** A powerful geometry kernel, the most important component of FreeCAD
37    * **Coin3D library** Open Inventor-compliant 3D scene representation model
38    * **Python** FreeCAD offers a broad Python API
39    * **Qt** Graphical user interface built with Qt
40
41
42Installing
43----------
44
45Precompiled packages for stable releases are available for Windows, macOS and Linux on the
46[Releases page](https://github.com/FreeCAD/FreeCAD/releases).
47
48On most Linux distributions, FreeCAD is also directly installable from the 
49software center application.
50
51For development releases check the [weekly-builds page](https://github.com/FreeCAD/FreeCAD-Bundle/releases/tag/weekly-builds).
52
53Other options are described at the [wiki Download page](https://wiki.freecadweb.org/Download).
54
55Build Status
56------------
57
58| Master | 0.20 | Translation |
59|:------:|:----:|:-----------:|
60|[![Master][freecad-master-status]][gitlab-branch-master]|[![0.20][freecad-0.20-status]][gitlab-branch-0.20]|[![Crowdin](https://d322cqt584bo4o.cloudfront.net/freecad/localized.svg)](https://crowdin.com/project/freecad)|
61
62[freecad-0.20-status]: https://gitlab.com/freecad/FreeCAD-CI/badges/releases/FreeCAD-0-20/pipeline.svg
63[freecad-master-status]: https://gitlab.com/freecad/FreeCAD-CI/badges/master/pipeline.svg
64[gitlab-branch-0.20]: https://gitlab.com/freecad/FreeCAD-CI/-/commits/releases/FreeCAD-0-20
65[gitlab-branch-master]: https://gitlab.com/freecad/FreeCAD-CI/-/commits/master
66[travis-builds]: https://travis-ci.org/FreeCAD/FreeCAD/builds
67
68Compiling
69---------
70
71Compiling FreeCAD requires installation of several libraries and their 
72development files such as OCCT (Open Cascade), Coin and Qt, listed in the 
73pages below. Once this is done, FreeCAD can be compiled with 
74CMake. On Windows, these libraries are bundled and offered by the 
75FreeCAD team in a convenient package. On Linux, they are usually found 
76in your distribution's repositories, and on macOS and other platforms, 
77you will usually have to compile them yourself.
78
79The pages below contain up-to-date build instructions:
80
81- [Linux](https://wiki.freecadweb.org/Compile_on_Linux)
82- [Windows](https://wiki.freecadweb.org/Compile_on_Windows)
83- [macOS](https://wiki.freecadweb.org/Compile_on_MacOS)
84- [Cygwin](https://wiki.freecadweb.org/Compile_on_Cygwin)
85- [MinGW](https://wiki.freecadweb.org/Compile_on_MinGW)
86
87
88Reporting Issues
89---------
90
91To report an issue please:
92- First post to forum to verify the issue; 
93- Link forum thread to bug tracker ticket and vice-a-versa; 
94- Use the most updated stable or development versions of FreeCAD; 
95- Post version info from eg. `Help > About FreeCAD > Copy to clipboard`; 
96- Post a Step-By-Step explanation on how to recreate the issue; 
97- Upload an example file to demonstrate problem. 
98
99For more detail see:
100- [Wiki Page about the Bug Tracker](https://wiki.freecadweb.org/Tracker)
101- [Bug Tracker](https://tracker.freecadweb.org)
102- [Help Forum](https://forum.freecadweb.org/viewforum.php?f=3)
103
104
105Usage & Getting help
106--------------------
107
108The FreeCAD wiki contains documentation on 
109general FreeCAD usage, Python scripting, and development. These 
110pages might help you get started:
111
112- [Getting started](https://wiki.freecadweb.org/Getting_started)
113- [Features list](https://wiki.freecadweb.org/Feature_list)
114- [Frequent questions](https://wiki.freecadweb.org/FAQ/en)
115- [Workbenches](https://wiki.freecadweb.org/Workbenches)
116- [Scripting](https://wiki.freecadweb.org/Power_users_hub)
117- [Development](https://wiki.freecadweb.org/Developer_hub)
118
119The [FreeCAD forum](https://forum.freecadweb.org) is also a great place
120to find help and solve specific problems you might encounter when
121learning to use FreeCAD.
122
123
124<p>This project receives generous infrastructure support from
125  <a href="https://www.digitalocean.com/">
126    <img src="https://opensource.nyc3.cdn.digitaloceanspaces.com/attribution/assets/SVG/DO_Logo_horizontal_blue.svg" width="91px">
127  </a> and <a href="https://www.kipro-pcb.com/">KiCad Services Corp.</a>
128</p>
129