Guida all'installazione di SolidCraft: Windows, macOS, Linux e web

Fonti: la guida ufficiale Getting started e la sezione Download del README. Ultima release monitorata qui: v0.16.2.

In questa pagina Download Windows macOS Linux Web Compilare dai sorgenti Primo modello Note sugli aggiornamenti

Se usi SolidCraft 0.11–0.14, il pulsante “Aggiorna ora” dell'app non riesce a installare la 0.15.0 o successive, perché le release sono state spostate su tangency-labs/solidcraft. Scarica la nuova versione da GitHub una sola volta: dopodiché gli aggiornamenti dall'app tornano a funzionare. Vedi le note ufficiali sugli aggiornamenti.

Prima di tutto, il download

Scegli il file giusto per il tuo sistema nella pagina di download di SolidCraft: tutti gli installer della v0.16.2, i link “latest” stabili e come verificare i checksum SHA-256. Poi segui qui sotto i passaggi per il tuo sistema.

Windows

Esegui l'MSI dell'ultima release.
Se compare l'avviso di SmartScreen, scegli Ulteriori informazioni → Esegui comunque.
In alternativa usa WinGet: winget install bherbruck.SolidCraft.

macOS

Apri il file .dmg della release e trascina SolidCraft in Applicazioni.
Al primo avvio: clic destro → Apri (build non firmata).

Linux

AppImage: chmod +x solidcraft-linux-x86_64.AppImage, poi avvialo.
Snap: sudo snap install solidcraft (la CLI dentro lo snap si chiama solidcraft.cli).
Flatpak: aggiungi il remote solidcraft da docs.solidcraft.io, poi flatpak install --user solidcraft ai.storyteller.solidcraft.
deb / rpm: installa il pacchetto adatto alla tua architettura (x86_64 o aarch64).

Comandi completi, come evitare la voce nel menu del desktop, supporti rimovibili, alternative per la GPU e dove si trova la CLI in ciascun pacchetto: SolidCraft su Linux.

Web app

Apri solidcraft.io/app. Parametri utili dalla documentazione:

?sample — apre il pezzo di esempio
?webgl — forza WebGL2 se WebGPU non funziona bene

I progetti vengono salvati nello spazio di archiviazione privato del browser (serve HTTPS o localhost). Dopo la prima visita l'app può funzionare offline da una copia conservata in locale.

Per l'hosting in proprio: immagine Docker ghcr.io/tangency-labs/solidcraft-web sulla porta 8080.

Compilare dai sorgenti

Serve Rust stable 1.95 o successivo (secondo la guida ufficiale 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

Il tuo primo modello

Installato? Il tutorial di SolidCraft ti guida nel primo pezzo parametrico: schizzo, quote, estrusione, raccordi, fori e modifica di un parametro. Spiega anche il pezzo di esempio (--sample / ?sample) e lo script della staffa per solidcraft-cli.

Le unità predefinite sono millimetri e gradi; l'asse Z punta verso l'alto.

Note sulla compatibilità

Repository e release si trovano ora in tangency-labs/solidcraft (spostati da bherbruck/solidcraft); i vecchi link GitHub vengono reindirizzati.
I remote Flatpak che puntano ancora a bherbruck.github.io vanno aggiornati a docs.solidcraft.io.
Per i vecchi ID di prodotto e dell'app (solvecraft ecc.) le note ufficiali sulla compatibilità descrivono come migrare.

Prossimi passi: modella il tuo primo pezzo · collega un agente AI tramite MCP · FAQ.