Guia de instalação do SolidCraft: Windows, macOS, Linux e web

Com base no Getting started oficial e na seção Download do README. Última versão acompanhada aqui: v0.16.2.

Nesta página Download Windows macOS Linux Web Compilar do código-fonte Primeiro modelo Notas de atualização

Se você usa o SolidCraft 0.11–0.14, o botão “Atualizar agora” do aplicativo não consegue instalar a 0.15.0 ou posterior, porque as versões passaram a ser publicadas em tangency-labs/solidcraft. Baixe a nova versão do GitHub uma única vez; depois disso, as atualizações pelo aplicativo voltam a funcionar. Veja as notas oficiais de atualização.

Primeiro, faça o download

Escolha o arquivo certo para o seu sistema na página de download do SolidCraft: todos os instaladores da v0.16.2, links “latest” permanentes e como verificar os checksums SHA-256. Depois, siga os passos do seu sistema abaixo.

Windows

Execute o MSI da versão mais recente.
Se o SmartScreen exibir um aviso, escolha Mais informações → Executar assim mesmo.
Ou use o WinGet: winget install bherbruck.SolidCraft.

macOS

Abra o .dmg da versão e arraste o SolidCraft para a pasta Aplicativos.
Na primeira execução: clique com o botão direito → Abrir (build não assinado).

Linux

AppImage: chmod +x solidcraft-linux-x86_64.AppImage e, em seguida, execute-o.
Snap: sudo snap install solidcraft (CLI dentro do snap: solidcraft.cli).
Flatpak: adicione o remoto solidcraft de docs.solidcraft.io e depois rode flatpak install --user solidcraft ai.storyteller.solidcraft.
deb / rpm: instale o pacote correspondente à sua arquitetura (x86_64 ou aarch64).

Comandos completos, como desativar a entrada no menu, mídias removíveis, alternativas de GPU e onde fica a CLI em cada pacote: SolidCraft no Linux.

Aplicativo web

Abra solidcraft.io/app. Parâmetros de URL citados na documentação:

?sample — abre a peça de exemplo
?webgl — força o WebGL2 se o WebGPU não funcionar bem

Os projetos são salvos no armazenamento privado do navegador (exige HTTPS ou localhost). Depois do primeiro acesso, o aplicativo funciona offline a partir de uma cópia guardada.

Opção de hospedagem própria: imagem Docker ghcr.io/tangency-labs/solidcraft-web na porta 8080.

Compilar do código-fonte

Requer Rust estável 1.95 ou mais recente (segundo o Getting started oficial).

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

Seu primeiro modelo

Já instalou? O tutorial do SolidCraft mostra passo a passo uma primeira peça paramétrica: esboço, cotas, extrusão, concordância, furos e alteração de um parâmetro. Ele também apresenta a peça de exemplo (--sample / ?sample) e o script do suporte para o solidcraft-cli.

As unidades padrão são milímetros e graus; o eixo Z aponta para cima.

Notas de compatibilidade

O repositório e as versões ficam em tangency-labs/solidcraft (antes em bherbruck/solidcraft); links antigos do GitHub são redirecionados.
Remotos Flatpak que ainda apontam para bherbruck.github.io precisam ser atualizados para docs.solidcraft.io.
Nomes de produto / IDs de aplicativo antigos (solvecraft etc.) têm caminhos de migração documentados nas notas oficiais de compatibilidade.

Próximos passos: modele sua primeira peça · conecte um agente de IA via MCP · perguntas frequentes.