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://www.freecadweb.org/wiki/) •
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]][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)
13
14<p>
15  <a href="https://www.digitalocean.com/?utm_medium=opensource&utm_source=FreeCAD">
16    <img src="https://opensource.nyc3.cdn.digitaloceanspaces.com/attribution/assets/PoweredByDO/DO_Powered_by_Badge_blue.svg" width="201px">
17  </a>
18</p>
19
20![screenshot](http://www.freecadweb.org/wiki/images/thumb/7/72/Freecad016_screenshot1.jpg/800px-Freecad016_screenshot1.jpg)
21
22Overview
23--------
24
25* **Freedom to build what you want**  FreeCAD is an open-source parametric 3D 
26modeler made primarily to design real-life objects of any size. 
27Parametric modeling allows you to easily modify your design by going back into 
28your model history and changing its parameters. 
29
30* **Create 3D from 2D & back** FreeCAD allows you to sketch geometry constrained
31 2D shapes and use them as a base to build other objects. 
32 It contains many components to adjust dimensions or extract design details from 
33 3D models to create high quality production ready drawings.
34
35* **Designed for your needs** FreeCAD is designed to fit a wide range of uses
36 including product design, mechanical engineering and architecture. 
37 Whether you are a hobbyist, a programmer, an experienced CAD user, 
38 a student or a teacher, you will feel right at home with FreeCAD.
39
40* **Cross platform** FreeCAD runs on Windows, Mac and Linux
41
42* **Underlying technology**
43    * **OpenCASCADE** A powerful geometry kernel, the most important component of FreeCAD
44    * **Coin3D library** Open Inventor-compliant 3D scene representation model
45    * **Python** FreeCAD offers a broad Python API
46    * **Qt** Graphical User Interface built with Qt
47
48
49Installing
50----------
51
52Precompiled (installable) packages are available for Windows and Mac on the
53[Releases page](https://github.com/FreeCAD/FreeCAD/releases).
54
55On most Linux distributions, FreeCAD is directly installable from the 
56software center application.
57
58Other options are described at the [wiki Download page](http://www.freecadweb.org/wiki/Download).
59
60Build Status <img src="https://blog.travis-ci.com/images/travis-mascot-200px.png" height="30"/>
61------------
62
63| Master | 0.18 | Translation |
64|:------:|:----:|:-----------:|
65|[![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)|
66
67[freecad-0.18-status]: https://travis-ci.org/FreeCAD/FreeCAD.svg?branch=releases/FreeCAD-0-18
68[freecad-master-status]: https://travis-ci.org/FreeCAD/FreeCAD.svg?branch=master
69[travis-branches]: https://travis-ci.org/FreeCAD/FreeCAD/branches
70[travis-builds]: https://travis-ci.org/FreeCAD/FreeCAD/builds
71
72Compiling
73---------
74
75Compiling FreeCAD requires installation of several libraries and their 
76development files such as OpenCASCADe, Coin and Qt, listed in the 
77pages below. Once this is done, FreeCAD can be simply compiled with 
78cMake. On Windows, these libraries are bundled and offered by the 
79FreeCAD team in a convenient package. On Linux, they are usually found 
80in your distribution's repositories, and on Mac OSX and other platforms 
81you will usually need to compile them yourself.
82
83The pages below contain up-to-date build instructions:
84
85- [Linux](http://www.freecadweb.org/wiki/CompileOnUnix)
86- [Windows](http://www.freecadweb.org/wiki/CompileOnWindows)
87- [Mac OSX](http://www.freecadweb.org/wiki/CompileOnMac)
88- [Cygwin](http://www.freecadweb.org/wiki/CompileOnCygwin)
89- [MinGW](http://www.freecadweb.org/wiki/CompileOnMinGW)
90
91Usage & Getting help
92--------------------
93
94The FreeCAD wiki contains documentation on 
95general FreeCAD usage, Python scripting, and development. These 
96pages might help you get started:
97
98- [Getting started](http://www.freecadweb.org/wiki/Getting_started)
99- [Features list](http://www.freecadweb.org/wiki/Feature_list)
100- [Frequent questions](http://www.freecadweb.org/wiki/FAQ)
101- [Workbenches](http://www.freecadweb.org/wiki/Workbench_Concept)
102- [Scripting](http://www.freecadweb.org/wiki/Power_users_hub)
103- [Development](http://www.freecadweb.org/wiki/Developer_hub)
104
105The [FreeCAD forum](http://forum.freecadweb.org) is also a great place
106to find help and solve specific problems you might encounter when
107learning to use FreeCAD.
108