Whet user guide, chapter 1, 2026-10-09
Getting started
Install Whet, open it, draw a plate, add a hole and a fillet, and save. About ten minutes. Every size is given so you can type the same ones and compare the figures.
What you are installing
Whet is one desktop application. It carries its own engines: FreeCAD for solid modelling, gmsh and CalculiX for strength and heat studies, ffmpeg for video and audio, and a physics engine for motion. You do not install them separately. You do not need an account, and your files stay on your machine.
The one engine Whet does not carry is Blender. It is used only for rendering and mesh editing, and you install it yourself if you want those. Rendering and video says how.
Install
macOS. Open the disk image and drag Whet into Applications. Whet runs on Apple silicon Macs only. There is no Intel build. The app is signed with a Developer ID and notarized by Apple. If macOS asks whether you want to open an app downloaded from the internet, confirm.
Linux. The .deb package installs Whet into your system and adds a menu entry. It needs glibc 2.35 or newer, for example Ubuntu 22.04 or later. System requirements has the numbers.
Windows. Run the installer. It is not code-signed yet, so SmartScreen shows "Windows protected your PC". Choose More info, then Run anyway. With Smart App Control on, Windows blocks unsigned installers, and this build cannot be installed on that PC.
The download is large, close to a gigabyte, because the engines are inside it. Allow a few gigabytes of disk space once it is installed.
First launch
When Whet opens for the first time, it shows a first-run page. It does three things.
- It checks the engines it carries and lists each one: FreeCAD, gmsh, CalculiX, ffmpeg and the physics engine. A row that is not found says so and says why.
- It shows your licence state. A key is checked on your machine, without a network connection. With no key, the copy runs as the trial and the row says "trial". To enter a key, use Help > Enter Licence Key. Licence, trial and updates says what the trial limits.
- It offers to set up a local language model for the assistant. You can skip this and do it later from the assistant page. The assistant covers it.
After that you land on the Home page, headed Start, with three groups: NEW, RECENT PROJECTS and SAMPLES.
- Part places a shape on the ground in a project.
- Sketch draws a profile on a plane, which you then pad into a solid.
- Assembly starts an assembly.
- Open... opens a folder that holds a Whet project.
- Samples copies one of four ready-made examples into your documents folder: a Bracket with a stress study, a Heat Sink with a heat study, a Gantry of three parts and joints, and a Bracket Render.
If you only want to look around first, open a sample. It shows you the panels with real data in them.
The window in one minute
The menu bar runs across the top. Below it are the workspace tabs (Model, Assemble, Test, Strength, Thermal, Media, Assist) and the command row, a set of captioned panels that changes with the workspace. A tool that cannot act right now is greyed, and its tooltip tells you why. The viewport is the large picture in the middle. The cube in its corner turns the camera to any face. The Model Tree lists the features that built the part. Properties shows the fields of whatever you select. The info line at the bottom says what the last action did, or why it was refused. When a step fails, read the info line first.
The panels
In the Model workspace the command row has the panels SKETCH, CREATE, MODIFY, PATTERN, INSPECT, INSERT and STUDY. Strength has SETUP, LOADS, SUPPORTS, SOLVE, RESULTS and REPORT; Thermal has SETUP, LOADS, SOLVE and REPORT; Assemble and Test have ASSEMBLE, INSERT, SOLVE and REPORT; Media has INSERT, RENDER and REPORT; an open sketch has SELECT, CREATE, SNAP, CONSTRAIN, SOLID and FINISH. The arrow under each caption lists every command in that panel, and a few commands are reached only from that list: Recompute, Edit Spec, Window Select, Build Part and Body Pattern. A second icon row carries EDIT, SELECT, TRANSFORM, SNAP, SETS, ARRANGE, LAYERS, TOOLS and RENDER. The menu bar paths in this guide (Part > ..., Sketch > ...) reach the same commands.
Your first part
You will draw an 80 by 40 mm plate, pad it 10 mm, drill a hole, round the corners and save.
1. Sketch
- Choose Sketch > New Sketch on XY. The viewport turns to look at the XY plane and the Sketch panel opens.
- In the panel, under Draw, choose Rectangle.
- Click one corner in the viewport, then click the opposite corner. Snaps help: with Endpoint, Midpoint and Grid on, the pointer locks to nearby points, and a small glyph under it tells you which snap caught.
- Pick one long side, choose Sketch > Dimension > Length and type 80. Repeat for a short side with 40. The box where you type appears on the picture. Press Return to accept a value and Escape to cancel it.
- Press Solve.
The panel then reports the degrees of freedom left. A drawn rectangle with both sides dimensioned still has two left, because nothing yet says where on the plane it sits. That is fine for padding. You can pin the corner to the origin if you want the plate there.
2. Pad
- In the panel, set Depth to 10 mm.
- Press Pad.
You now have a solid. The info line gives its volume. An 80 by 40 by 10 mm plate is 32000 mm3. If your number differs, check your dimensions and the depth. Pad waits for the latest solve, and while a solve runs the step list says running, not done.
Press Finish to leave the sketch.
3. Hole
- Click the top face of the plate so it lights.
- Choose Part Design > Hole. A form opens.
- Pick a metric size from the table. The form offers tapped holes, clearance holes, counterbores and countersinks.
- Set the depth and confirm.
As a check, an M6 tapped hole 8 mm deep in the 80 by 40 by 10 plate takes the volume to 31842.92 mm3. The tap drill for M6 is 5 mm, and the number is the plate minus that cylinder. A hole is a real cut in the solid and the solid stays one solid.
4. Fillet
- Pick an edge. Press 2 to pick edges, then click a vertical corner edge of the plate. You can add the other three the same way.
- Press Fillet in the MODIFY panel. A form opens with a radius.
- Type 3 for the radius.
- Wait for the preview. The Apply button stays greyed until the preview has solved. When it turns on, press it.
Four vertical corner edges, 10 mm tall, filleted at 3 mm remove 4 x (1 - pi/4) x 3 x 3 x 10 = 77.26 mm3. With the M6 hole in place you should read about 31765.66 mm3. The fillet form is covered in Modelling.
If Undo is needed, use Edit > Undo. Whet keeps a history of each step of a part. A step you undo can be redone.
5. Save
There are two kinds of saving, and you will probably use both.
Save Project (Command-S on macOS, Control-S elsewhere) writes your project file. If the part has changed since its last export, Whet first writes the part out, so the project file names the part you see on screen. The first time you save, it asks for a name. A project file ends in .whetproj.json.
File > Export > Export STEP writes the part itself. It asks for a name and writes four files into your project: the STEP file, an STL mesh, a build record, and a spec file that holds the part's history. Other CAD programs read the STEP. To bring the part back later with its history, use Part > Kernel > Open on Kernel... and choose the spec file. The Model Tree comes back as you left it.
Parts export as STEP and STL only. IGES, BREP, OBJ, PLY, 3MF, OFF and FCStd are greyed in the Export menu, with the reason in the tooltip. Import and export lists what can come in.
Where to go next
- Modelling for primitives, push and pull, direct editing and booleans.
- Strength and heat to study the plate under load. A part you made by hand can go straight to a study.
- The assistant to ask questions about your part and have steps proposed.
- Known limits before you plan a project around a feature.