igsova / SimpleCAD

# SimpleCAD
**Direct modeling for FreeCAD, in the spirit of SketchUp.** Draw a shape, pull
it into a solid, then keep editing its faces and edges directly. There are no
sketches, constraints or feature tree to manage, and imported STL meshes can be
edited as they are.
## Features
- **Draw and pull.** Line, Rectangle, Circle, Arc, Polygon and Sphere. Lines
 and outlines can also be drawn directly on curved faces. Push/Pull turns any
 flat region into a boss, a pocket or a through-hole. Type exact sizes with
 units (`40, 30`, `2 cm`, `1 in`) at any point while drawing.
- **Edit any shape.** Divide faces with lines, then offset, round, slice,
 union, intersect, bend, scale, loft, sweep, mirror or pattern them. This
 works on any plain Part shape, including converted STL meshes.
- **Curved surfaces.** Draw on curved faces, offset them, shell or thicken a
 part, add draft, remove fillets, fill holes, unwrap a face, and show a
 curvature map.
- **STL meshes without conversion.** Split a mesh with an optional glue seam,
 stretch it between two planes, or move, rotate and extrude a patch of
 triangles. When you need CAD faces, **Make mesh editable** fits planes,
 cylinders and smooth surfaces.
- **Snapping and measuring.** Snap to endpoints, midpoints, face and hole
 centers and the X/Y/Z axes. Measure hole diameters, spacing, distances and
 angles, and leave dimensions in the view.
- **Plain FreeCAD files.** Results are ordinary Part and Mesh objects in
 `.FCStd` documents that open without SimpleCAD installed. Every edit is one
 Undo step.
- **AI-ready.** A local MCP server lets AI clients such as
 Claude or Codex inspect and edit the open model with the same operations as
 the toolbar.
https://github.com/user-attachments/assets/3ee6a401-5bb9-443b-8c6b-4076e62b04a1
## Requirements
- FreeCAD **1.1** or later. SimpleCAD is developed with FreeCAD 1.1.3.
- Nothing else to install: FreeCAD's own installers include Python,
 OpenCascade, Qt, Coin, NumPy and SciPy. A FreeCAD from a Linux distribution
 package may need its `numpy` and `scipy` Python packages installed too.
- Developed and used on macOS. The automated tests also run on Linux. Windows
 has not been tested yet; reports are welcome.
## Install
### Addon Manager
1. In FreeCAD, open **Edit → Preferences → Addon Manager**.
2. Under **Custom repositories**, add `https://github.com/igsova/SimpleCAD`
 with branch `main`.
3. Open **Tools → Addon manager**, find **SimpleCAD** and install it.
4. Restart FreeCAD and choose **SimpleCAD** in the workbench selector.
### Manual
Clone or unzip the repository into FreeCAD's `Mod` folder, so that
`InitGui.py` sits directly inside `Mod/SimpleCAD`:
 [code] 
To find the `Mod` folder, open **View → Panels → Python console** in FreeCAD
and run `App.getUserAppDataDir()`; `Mod` is inside the folder it prints.
For FreeCAD 1.1 it is usually:
| System | Mod folder |
| --- | --- |
| macOS | `~/Library/Application Support/FreeCAD/v1-1/Mod` |
| Linux | `~/.local/share/FreeCAD/v