Badges and one-line instructions for Windows, macOS, Linux and the web app, right after the tagline and demo. The links use releases/latest/download with version-less file names, which release.yml now attaches (and checksums) alongside the versioned installers. The Flatpak note and the name/compatibility section move into the book's Getting started page. Claude-Session: https://claude.ai/code/session_01RjGw4gA5ZvKrU8MQP6sBgT Co-authored-by: Claude Opus 5.5 <[email protected]>
4.3 KiB
SolidCraft is open-source parametric 3D CAD in Rust: sketch, constrain, extrude, and change a
parameter to watch the timeline rebuild. Documentation
· try it in the browser ·
contributing ·
issues. AI agents can model with it over MCP:
solidcraft-cli mcp (how).
Renamed to SolidCraft. Everything now uses the new name: the solidcraft and
solidcraft-cli programs, .solidcraft designs, SOLIDCRAFT_* environment variables,
settings folders, package names and the solidcraft MCP server. Upgrading from SolveCraft:
.solvecraftdesigns still open (double-click, Open, drag-drop, the CLI and MCP); new saves are.solidcraft. Builds older than this one can't open files saved by it.- Settings, preferences and recovery files are copied to the new folders on first launch; the
old folders are left in place.
SOLVECRAFT_*environment variables are still read. solvecraft-cliremains as a deprecated alias for one release; it forwards tosolidcraft-cliand prints a note. Agents:claude mcp add solidcraft -- solidcraft-cli mcp; an existingclaude mcp add solvecraft -- solvecraft-cli mcpsetup keeps working.- Windows: the
.msiupgrades the existing installation in place (now inProgram Files\SolidCraft). Linux: thesolidcraft.deb/.rpmreplaces thesolvecraftpackage. The Flatpak app ID staysai.storyteller.solvecraft, soflatpak updatejust works, and existing AppImages find the update. - macOS: quit the app, move the old
SolveCraft.appto the Trash (your designs and settings stay), then dragSolidCraft.appfrom the DMG onto Applications and pin it in the Dock. - Details: compatibility notes.
Documentation, the browser app and the Flatpak feed use the SolidCraft project Pages URLs; old-name Pages addresses are not permanent aliases.
Which file?
- Windows:
SolidCraft-{version}-windows-x64.exeruns as is. Or install the.msi, or unzip the-portable.zip(x64, x86 and arm64). - macOS 11+ (Apple silicon and Intel): open the
.dmgand dragSolidCraft.apponto Applications. The CLI is insolidcraft-cli-{version}-macos-universal.zip. - Linux (x86_64 and aarch64, glibc 2.35+): the
.AppImage(chmod +x, then run it), the.debor.rpm, the.flatpak(flatpak install --user <file>), or the.tar.gz. - FreeBSD:
tar -xzf solidcraft-{version}-freebsd-x86_64.tar.gz --strip-components 1 -C /usr/local. - Web:
solidcraft-web-{version}.zipis a static site to host yourself. SHA256SUMS.txt:sha256sum -c SHA256SUMS.txt --ignore-missing.- Files without a version in the name (
solidcraft-windows-x64.msi,solidcraft-linux-x86_64.AppImage, …) are the same packages under fixed names, for download links that always fetch the latest release.
For Flatpak feed installation and updates, add Flathub for the required runtime before installing SolidCraft; keep both remotes in the same user installation:
flatpak remote-add --user --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo
flatpak remote-add --user --if-not-exists solidcraft https://bherbruck.github.io/solidcraft/flatpak/solidcraft.flatpakrepo
flatpak install --user solidcraft ai.storyteller.solvecraft
flatpak run ai.storyteller.solvecraft
Single-file .flatpak bundles include the runtime repository address; missing runtimes
still need an internet connection. Linux installation details.
The builds aren't signed yet. On macOS, right-click SolidCraft.app in Applications and choose
Open the first time (or run xattr -dr com.apple.quarantine /Applications/SolidCraft.app).
On Windows, SmartScreen may say "Windows protected your PC": More info, then Run anyway.
Licences are built in (Help ▸ About ▸ Licences, solidcraft-cli licences); the packages also
install THIRD-PARTY-LICENSES.txt. Known limitations:
ROADMAP.md.