
Install and update
With ArtCraft Launcher
Section titled “With ArtCraft Launcher”ArtCraft Launcher installs, updates and opens every app in the Craft App Suite, Craft Anything included. It picks the right build for your system and processor, checks it against the release’s SHA-256 checksums before installing it, and tells you when an update is out.
Download it from its latest release, then press Install on Craft Anything’s card.
By hand
Section titled “By hand”Every build is on the latest release page; all releases has earlier versions and their notes. In the file names below, <ver> is the version number. SHA256SUMS.txt lists a checksum for every file.
Windows
Section titled “Windows”| Build | Installer | Portable |
|---|---|---|
| x64 (64-bit Intel or AMD) | craft-anything-<ver>-windows-x64.msi |
craft-anything-<ver>-windows-x64-portable.zip |
| arm64 (Snapdragon and other ARM PCs) | craft-anything-<ver>-windows-arm64.msi |
craft-anything-<ver>-windows-arm64-portable.zip |
| x86 (32-bit) | craft-anything-<ver>-windows-x86.msi |
craft-anything-<ver>-windows-x86-portable.zip |
Installers and programs are code-signed. The installer sets Craft Anything up for everyone on the computer, in C:\Program Files\Craft Anything, so Windows asks for administrator permission. The portable zip needs no installing and keeps its settings next to the app, in CraftAnythingData.
| Build | File |
|---|---|
| App, universal (Apple silicon and Intel) | craft-anything-<ver>-macos-universal.dmg |
| Command-line tool only, universal | craft-anything-cli-<ver>-macos-universal.zip |
Both are signed and notarized, and need macOS 11 (Big Sur) or later. The app includes the command-line tool, so you only need the zip to use the command line without the app.
If macOS says “Apple could not verify craft-anything-cli” for the zip’s tool, press Done and see macOS blocks the command-line tool.
| Format | Files (x86_64 and aarch64) | Notes |
|---|---|---|
| AppImage | craft-anything-<ver>-linux-<arch>.AppImage |
Runs without installing; updates with AppImageUpdate |
| Debian, Ubuntu | craft-anything-<ver>-linux-<arch>.deb |
|
| Fedora, RHEL, openSUSE | craft-anything-<ver>-linux-<arch>.rpm |
|
| Arch | craft-anything-<ver>-linux-<arch>.pkg.tar.zst |
|
| Flatpak | craft-anything-<ver>-linux-<arch>.flatpak |
flatpak install --user <file>; can’t study websites (see below) |
| Tarball | craft-anything-<ver>-linux-<arch>.tar.gz |
Unpack anywhere |
RISC-V (riscv64) has a .deb, an .rpm and a tarball. Apart from the Flatpak, the Linux builds need glibc 2.35 or newer: Ubuntu 22.04 or later, or a distribution of the same age.
The AppImage carries the command-line tool too: run <AppImage> --cli <command>, or make a link to the AppImage named craft-anything-cli.
For updates through your package manager, add the ArtCraft Linux repositories (Flatpak, Debian, Ubuntu, Fedora, RHEL, openSUSE and Arch).
FreeBSD
Section titled “FreeBSD”craft-anything-<ver>-freebsd-x86_64.tar.gz and craft-anything-<ver>-freebsd-aarch64.tar.gz.
In a browser
Section titled “In a browser”craft-anything-web-<ver>.zip is a small viewer that says what a file is, without the file leaving your browser. Host the folder on any static web server.
Check the install
Section titled “Check the install”craft-anything-cli doctorIt checks the install, the coding agents it can use and the engines. Troubleshooting says where to find craft-anything-cli if your terminal doesn’t.
Update
Section titled “Update”An installed Craft Anything keeps its settings outside the app’s folder, and your projects are in Documents/Craft Anything, so an update keeps both:
- ArtCraft Launcher: tells you when a new version is out and updates it for you.
- Installer, DMG,
.deb,.rpm: install the new version over the old one, or update through the Linux repositories. - Portable zip: its settings are in its own
CraftAnythingDatafolder; unpack the new version and move that folder next to it. - AppImage: run AppImageUpdate on it, or download the new one.
Uninstall
Section titled “Uninstall”-
If you connected Craft Anything to coding-agent apps with
craft-anything-cli setup, remove those connections:Terminal window craft-anything-cli uninstall -
API keys you added are kept in your system keychain. To remove them, choose Remove it and its key for each one in Settings → AI.
-
Remove the app the usual way for your system:
- Windows: in Settings → Apps, find Craft Anything and choose Uninstall. For the portable zip, delete its folder.
- macOS: move Craft Anything from Applications to the Trash.
- Linux: remove the package with your package manager, run
flatpak uninstall ai.storyteller.craft-anythingfor the Flatpak, or delete the AppImage or the unpacked tarball.
-
Your settings and projects stay. To remove them too, delete the settings folder (see Find the log for where it is) and your projects folder,
Documents/Craft Anythingunless you changed it.
Build from source
Section titled “Build from source”You need Rust 1.97 or newer (rustup update). On Debian or Ubuntu, the desktop app also needs:
sudo apt-get install libxkbcommon-dev libwayland-dev libx11-dev libxrandr-dev libxi-dev libgl1-mesa-dev libgtk-3-devThen:
git clone https://github.com/storytold/craft-anything && cd craft-anythingcargo run --release -p craft-anything # the desktop appcargo install --path apps/craft-anything-cli # the command-line tool