Repository navigation
Home
Anand edited this page Oct 14, 2026
·
2 revisions
Whittle is free, open-source parametric 3D CAD for everyone: first-timers, makers, designers and engineers. Sketch a shape, pull it into 3D, round the edges, and export it for 3D printing, laser cutting, CNC or other CAD software.
It uses a real CAD kernel (OpenCascade), so you get exact solids, true fillets and STEP export, not just meshes.
| System | Run this |
|---|---|
| Windows (PowerShell) | irm https://raw.githubusercontent.com/anand34577/whittle/main/install.ps1 | iex |
| macOS and Linux (Terminal) | curl -fsSL https://raw.githubusercontent.com/anand34577/whittle/main/install.sh | sh |
| Server on Linux, bare metal or LXC | curl -fsSL https://raw.githubusercontent.com/anand34577/whittle/main/install.sh | sh -s -- --server |
| Server with Docker | docker run -d --name whittle -p 8080:8080 -v whittle-data:/data --restart unless-stopped ghcr.io/anand34577/whittle:latest |
Prefer clicking? Download an installer from the latest release. Details for every system: Installation.
| Desktop app | Self-hosted server | Static web build | |
|---|---|---|---|
| Best for | one person, works offline | families, teams, classrooms, several computers | trying it out, embedding |
| Sign-in | none | your choice: none, accounts, single sign-on, or both | none |
| Your designs | ordinary .whittle files anywhere on your disk |
each person's library on the server | browser storage and downloads |
| Version history | every save keeps the previous copy on your computer | every save is a version on the server | every save keeps a copy in the browser |
| Install | Installation | Self-Hosting or Docker | Building from source |
- Getting Started: your first part in five minutes.
- The Interface: what's on the screen.
- Sketching and 3D Features: the tools.
- Keyboard Shortcuts: work faster.
Stuck? See Troubleshooting and FAQ, or open an issue.
Using Whittle
- Getting Started
- The Interface
- Sketching
- 3D Features
- Parts Library and Templates
- Parameters and Formulas
- Timeline and Selection
- Measure, View and Appearance
- Files, Import and Export
- Version History
- Errors and Warnings
- Keyboard Shortcuts
Installing
- Installation: Windows, macOS, Linux
- Updating and Uninstalling
Running a server
- Self-Hosting: Linux, LXC, Proxmox
- Docker
- Configuration: every setting
- Single Sign-On: Authentik, Keycloak, Authelia, Google, Entra ID…
- HTTPS and Reverse Proxy
- Users and Administration
- Backups and Upgrades
Help and development
Download · Source code · Report a problem · Whittle is open source under the MPL-2.0 license.
Install
Use
- Getting Started
- The Interface
- Sketching
- 3D Features
- Parts and Templates
- Parameters and Formulas
- Timeline and Selection
- Measure, View, Appearance
- Files, Import, Export
- Version History
- Errors and Warnings
- Keyboard Shortcuts
Self-host
- Self-Hosting
- Docker
- Configuration
- Single Sign-On
- HTTPS and Reverse Proxy
- Users and Administration
- Backups and Upgrades
Help