170965a32SMarkus Reitboeck![Logo](https://www.freecadweb.org/images/logo.png)
270965a32SMarkus Reitboeck
370965a32SMarkus Reitboeck### Your own 3D parametric modeler
470965a32SMarkus Reitboeck
570965a32SMarkus Reitboeck[Website](https://www.freecadweb.org) • 
65bf83c52SYorik van Havre[Documentation](https://www.freecadweb.org/wiki/) •
770965a32SMarkus Reitboeck[Forum](https://forum.freecadweb.org/) •
85bf83c52SYorik van Havre[Bug tracker](https://www.freecadweb.org/tracker/) •
95bf83c52SYorik van Havre[Git repository](https://github.com/FreeCAD/FreeCAD)
10ea3e3253SMarkus Reitboeck
11ea3e3253SMarkus Reitboeck
12c77937e6SYorik van Havre[![Release](https://img.shields.io/github/release/freecad/freecad.svg)](https://github.com/freecad/freecad/releases/latest) [![Master][freecad-master-status]][travis-branches] [![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)
13bec97f0aSMarkus Reitboeck
148deed98aSKurt Kremitzki<p>
158deed98aSKurt Kremitzki  <a href="https://www.digitalocean.com/?utm_medium=opensource&utm_source=FreeCAD">
168deed98aSKurt Kremitzki    <img src="https://opensource.nyc3.cdn.digitaloceanspaces.com/attribution/assets/PoweredByDO/DO_Powered_by_Badge_blue.svg" width="201px">
178deed98aSKurt Kremitzki  </a>
188deed98aSKurt Kremitzki</p>
19f045dfc1SYorik van Havre
2070965a32SMarkus Reitboeck![screenshot](http://www.freecadweb.org/wiki/images/thumb/7/72/Freecad016_screenshot1.jpg/800px-Freecad016_screenshot1.jpg)
21bec97f0aSMarkus Reitboeck
226afe45eaSMarkus ReitboeckOverview
236afe45eaSMarkus Reitboeck--------
246afe45eaSMarkus Reitboeck
256afe45eaSMarkus Reitboeck* **Freedom to build what you want**  FreeCAD is an open-source parametric 3D 
266afe45eaSMarkus Reitboeckmodeler made primarily to design real-life objects of any size. 
276afe45eaSMarkus ReitboeckParametric modeling allows you to easily modify your design by going back into 
286afe45eaSMarkus Reitboeckyour model history and changing its parameters. 
296afe45eaSMarkus Reitboeck
306afe45eaSMarkus Reitboeck* **Create 3D from 2D & back** FreeCAD allows you to sketch geometry constrained
316afe45eaSMarkus Reitboeck 2D shapes and use them as a base to build other objects. 
326afe45eaSMarkus Reitboeck It contains many components to adjust dimensions or extract design details from 
336afe45eaSMarkus Reitboeck 3D models to create high quality production ready drawings.
346afe45eaSMarkus Reitboeck
356afe45eaSMarkus Reitboeck* **Designed for your needs** FreeCAD is designed to fit a wide range of uses
366afe45eaSMarkus Reitboeck including product design, mechanical engineering and architecture. 
376afe45eaSMarkus Reitboeck Whether you are a hobbyist, a programmer, an experienced CAD user, 
386afe45eaSMarkus Reitboeck a student or a teacher, you will feel right at home with FreeCAD.
396afe45eaSMarkus Reitboeck
406afe45eaSMarkus Reitboeck* **Cross platform** FreeCAD runs on Windows, Mac and Linux
416afe45eaSMarkus Reitboeck
426afe45eaSMarkus Reitboeck* **Underlying technology**
435bf83c52SYorik van Havre    * **OpenCASCADE** A powerful geometry kernel, the most important component of FreeCAD
446afe45eaSMarkus Reitboeck    * **Coin3D library** Open Inventor-compliant 3D scene representation model
456afe45eaSMarkus Reitboeck    * **Python** FreeCAD offers a broad Python API
466afe45eaSMarkus Reitboeck    * **Qt** Graphical User Interface built with Qt
47ff7deabfSYorik van Havre
48f045dfc1SYorik van Havre
490e1b09a4SYorik van HavreInstalling
507fd2157aSYorik van Havre----------
510e1b09a4SYorik van Havre
520f9d6c14SYorik van HavrePrecompiled (installable) packages are available for Windows and Mac on the
5338c88849SKurt Kremitzki[Releases page](https://github.com/FreeCAD/FreeCAD/releases).
544f6a50acSYorik van Havre
550f9d6c14SYorik van HavreOn most Linux distributions, FreeCAD is directly installable from the 
560f9d6c14SYorik van Havresoftware center application.
570f9d6c14SYorik van Havre
58bb52cd1fSKundaOther options are described at the [wiki Download page](http://www.freecadweb.org/wiki/Download).
590e1b09a4SYorik van Havre
60cfe2aa7eSluzpazBuild Status <img src="https://blog.travis-ci.com/images/travis-mascot-200px.png" height="30"/>
61e4c94516SBruce B. Lacey------------
62e4c94516SBruce B. Lacey
63eaf4be7cSMarkus Reitboeck| Master | 0.18 | Translation |
648b8b4237SYorik van Havre|:------:|:----:|:-----------:|
65eaf4be7cSMarkus Reitboeck|[![Master][freecad-master-status]][travis-branches]|[![0.18][freecad-0.18-status]][travis-branches]|[![Crowdin](https://d322cqt584bo4o.cloudfront.net/freecad/localized.svg)](https://crowdin.com/project/freecad)|
66e4c94516SBruce B. Lacey
67eaf4be7cSMarkus Reitboeck[freecad-0.18-status]: https://travis-ci.org/FreeCAD/FreeCAD.svg?branch=releases/FreeCAD-0-18
68e4c94516SBruce B. Lacey[freecad-master-status]: https://travis-ci.org/FreeCAD/FreeCAD.svg?branch=master
69e4c94516SBruce B. Lacey[travis-branches]: https://travis-ci.org/FreeCAD/FreeCAD/branches
70e4c94516SBruce B. Lacey[travis-builds]: https://travis-ci.org/FreeCAD/FreeCAD/builds
71e4c94516SBruce B. Lacey
720e1b09a4SYorik van HavreCompiling
737fd2157aSYorik van Havre---------
74f045dfc1SYorik van Havre
75726a514eSJ BradshawCompiling FreeCAD requires installation of several libraries and their 
7638c88849SKurt Kremitzkidevelopment files such as OpenCASCADe, Coin and Qt, listed in the 
77ff7deabfSYorik van Havrepages below. Once this is done, FreeCAD can be simply compiled with 
78726a514eSJ BradshawcMake. On Windows, these libraries are bundled and offered by the 
7938c88849SKurt KremitzkiFreeCAD team in a convenient package. On Linux, they are usually found 
8038c88849SKurt Kremitzkiin your distribution's repositories, and on Mac OSX and other platforms 
81ff7deabfSYorik van Havreyou will usually need to compile them yourself.
82f045dfc1SYorik van Havre
83f045dfc1SYorik van HavreThe pages below contain up-to-date build instructions:
84f045dfc1SYorik van Havre
85bb52cd1fSKunda- [Linux](http://www.freecadweb.org/wiki/CompileOnUnix)
86bb52cd1fSKunda- [Windows](http://www.freecadweb.org/wiki/CompileOnWindows)
87bb52cd1fSKunda- [Mac OSX](http://www.freecadweb.org/wiki/CompileOnMac)
88bb52cd1fSKunda- [Cygwin](http://www.freecadweb.org/wiki/CompileOnCygwin)
89bb52cd1fSKunda- [MinGW](http://www.freecadweb.org/wiki/CompileOnMinGW)
90ff7deabfSYorik van Havre
91ff7deabfSYorik van HavreUsage & Getting help
927fd2157aSYorik van Havre--------------------
93f045dfc1SYorik van Havre
9438c88849SKurt KremitzkiThe FreeCAD wiki contains documentation on 
9538c88849SKurt Kremitzkigeneral FreeCAD usage, Python scripting, and development. These 
96726a514eSJ Bradshawpages might help you get started:
97f045dfc1SYorik van Havre
98bb52cd1fSKunda- [Getting started](http://www.freecadweb.org/wiki/Getting_started)
99bb52cd1fSKunda- [Features list](http://www.freecadweb.org/wiki/Feature_list)
100bb52cd1fSKunda- [Frequent questions](http://www.freecadweb.org/wiki/FAQ)
101bb52cd1fSKunda- [Workbenches](http://www.freecadweb.org/wiki/Workbench_Concept)
102bb52cd1fSKunda- [Scripting](http://www.freecadweb.org/wiki/Power_users_hub)
103bb52cd1fSKunda- [Development](http://www.freecadweb.org/wiki/Developer_hub)
1040e1b09a4SYorik van Havre
10538c88849SKurt KremitzkiThe [FreeCAD forum](http://forum.freecadweb.org) is also a great place
106726a514eSJ Bradshawto find help and solve specific problems you might encounter when
107ff7deabfSYorik van Havrelearning to use FreeCAD.
108