SnapWeaver

Before You Begin

This guide walks you through installing SnapWeaver on Windows, macOS, and Linux. We also cover portable and headless options for CI/CD pipelines.

System Requirements

• 64‑bit CPU (Intel, AMD, or Apple Silicon)
• 4 GB RAM minimum (8 GB recommended for AI filters)
• OpenGL 3.3‑compatible GPU or later
• Disk space: ~400 MB for the core app, plus workspace
• Internet connection for first‑time model download (offline thereafter)

Windows

Installer

1. Download SnapWeaver‑Setup‑x64.exe from the Releases page.
2. Double‑click the installer and follow the wizard (Admin rights not required).
3. Launch SnapWeaver from the Start menu.

Chocolatey (alternative)

choco install snapweaver --version 1.0.0

macOS

Homebrew

brew tap woven-code/snapweaver
brew install snapweaver

The cask installs a signed universal binary for both Intel and Apple Silicon.

DMG (manual)

1. Mount SnapWeaver‑1.0.0.dmg.
2. Drag SnapWeaver.app into /Applications.

Linux

Debian & Ubuntu

sudo apt update
sudo apt install ./snapweaver_1.0.0_amd64.deb

Fedora, RHEL, CentOS

sudo dnf install snapweaver-1.0.0.x86_64.rpm

AppImage (portable)

chmod +x SnapWeaver‑1.0.0.AppImage
./SnapWeaver‑1.0.0.AppImage

Docker (Headless/CI)

# Pull
docker pull woven/snapweaver:1.0.0

# Run a quick batch job
docker run --rm -v $(pwd):/data woven/snapweaver:1.0.0 \
  apply --filter "dreamscape" --input /data/cat.jpg --output /data/cat‑dream.jpg

This image ships with GPU passthrough (CUDA 12). Add --gpus all on NVIDIA‑enabled hosts.

Verify Your Installation

snapweaver --version
snapweaver self‑test

The self‑test command renders a sample image and checks GPU drivers.

Uninstall

All platforms support a single command to remove binaries and caches:

snapweaver uninstall

On desktop OSes, you can also drag the application to the system trash/recycle bin.

Next Steps

You’re ready to start creating! Head over to the Quickstart Tutorial or dive straight into the CLI Reference.