SolidCraft install & first model

Sourced from official Getting started and the README Download section. Latest release tracked here: v0.16.2.

On this page Download Windows macOS Linux Web Build from source First model Upgrading notes

If you are on SolidCraft 0.11–0.14, in-app “Update now” cannot install 0.15.0 or later because releases moved to tangency-labs/solidcraft. Download the new version once from GitHub; after that, in-app updates work again. See official update notes.

1 · Download

Get installers from the latest GitHub release. Builds are not code-signed yet.

Windows: MSI for x64 (also ARM64 and 32-bit), or portable zip. WinGet: winget install bherbruck.SolidCraft.
macOS: universal .dmg (Apple silicon and Intel).
Linux: AppImage, .deb, .rpm, Snap, Flatpak; ARM64 packages available.
Web: solidcraft.io/app — no install.

Windows

Run the MSI from the latest release.
If SmartScreen warns, choose More info → Run anyway.
Or use WinGet: winget install bherbruck.SolidCraft.

macOS

Open the release .dmg and drag SolidCraft into Applications.
First launch: right-click → Open (unsigned build).

Linux

AppImage

Download the AppImage, mark it executable, and run it. On first open it can add a menu entry under ~/.local/share (see official docs for opt-out).

Snap

sudo snap install solidcraft
solidcraft
solidcraft.cli --version   # CLI name inside the snap

For USB / removable media: sudo snap connect solidcraft:removable-media.

Flatpak (user install with updates)

flatpak remote-add --user --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo
flatpak remote-add --user --if-not-exists solidcraft https://docs.solidcraft.io/flatpak/solidcraft.flatpakrepo
flatpak install --user solidcraft ai.storyteller.solidcraft
flatpak run ai.storyteller.solidcraft

Or install a release .flatpak bundle: flatpak install --user ./solidcraft-VERSION-linux-ARCH.flatpak.

deb / rpm

Use the architecture-matching packages from the release assets (x86_64 or aarch64).

Web app

Open solidcraft.io/app. Query tips from the docs:

?sample — open the sample part
?webgl — force WebGL2 if WebGPU misbehaves

Designs save in the browser’s private storage (needs HTTPS or localhost). After the first visit the app can work offline from a kept copy.

Self-host option: Docker image ghcr.io/tangency-labs/solidcraft-web on port 8080.

Build from source

Needs stable Rust 1.95 or newer (per official Getting started).

git clone https://github.com/tangency-labs/solidcraft
cd solidcraft
cargo run --release -p solidcraft -- --sample
cargo run --release -p solidcraft-cli -- run examples/bracket.json --out bracket.step

First model walkthrough

Two easy paths (both from official materials):

A · Sample part

Launch with --sample, or open the web app with ?sample. Explore the timeline and change a parameter.

B · Bracket script

Run the official example script headlessly:

solidcraft-cli run examples/bracket.json --out bracket.step
solidcraft-cli eval examples/bracket.json

Source: examples/bracket.json.

In the UI, the usual flow is: create a sketch on a plane → draw and dimension → finish sketch → extrude → fillet / shell as needed → change parameters and watch the timeline rebuild.

Units default to millimetres and degrees; Z is up.

Compatibility notes

Repo and releases live under tangency-labs/solidcraft (moved from bherbruck/solidcraft); old GitHub links redirect.
Flatpak remotes that still point at bherbruck.github.io need updating to docs.solidcraft.io.
Older product / app IDs (solvecraft, etc.) have documented migration paths in the official compatibility notes.

Next: connect an AI agent via MCP · browse examples.