mold

Local AI image and video generation on your own GPU. Mold supports NVIDIA CUDA and Apple Silicon Metal, with a CLI, native desktop app, web studio, TUI, mobile companions, Discord bot, and REST/SSE API built on the same engine.

Documentation · Models · Desktop guide · API

Install

Stable release:

curl -fsSL https://raw.githubusercontent.com/utensils/mold/main/install.sh | sh

Nightly CLI from the latest published main build:

curl -fsSL https://raw.githubusercontent.com/utensils/mold/main/install.sh | MOLD_CHANNEL=nightly sh

The installer selects a compatible build and verifies its checksum. See the installation guide for Nix, Arch, Windows, Android, and source builds. GH200, GB200, and GB300 require future linux/arm64 artifacts and are unsupported.

Quick start

# Generate with the default model
mold run "a cat riding a motorcycle through neon-lit streets"

# Choose a model and reproducible seed
mold run flux-dev:q4 "a sunset over mountains" --seed 42

# Edit an image
mold run qwen-image-edit-2511:q4 "make the chair red" --image chair.png

# Generate video
mold run ltx-video-0.9.6-distilled:bf16 "a fox in the snow" --frames 25

# Turn a photo into a 3D mesh
mold run hunyuan3d-mini-turbo --image chair.png -o chair.glb

# Upscale a Library video as a durable framewise job
mold video-upscale create clip.mp4 --wait

# Launch the web studio and API
mold serve

Models download automatically on first use. Generated media is saved locally with prompt, model, seed, and generation metadata. Framewise video upscale also needs the host codec bridge: Nix packages and CUDA containers include it, while raw binary installs must provide ffmpeg and ffprobe on PATH before the server advertises that feature.

What it supports

• Models: FLUX.1, Flux.2, Stable Diffusion, Z-Image, Qwen-Image, Wuerstchen, LTX Video, Wan, MiniMax H3, and Hunyuan3D. See the model catalog for variants and hardware requirements.
• Images: text-to-image, image editing, inpainting, ControlNet, LoRA, identity photos, prompt expansion, and upscaling.
• Video and audio: text/image-to-video, sequences, clip continuation, lip dub, text-to-audio, and MP4 output with generated audio.
• 3D: image-to-mesh with Hunyuan3D, no prompt required, published to the Library as binary glTF with a rendered poster tile, exportable as OBJ, STL, or PLY, or shared as a turntable GIF, APNG, or WebP.
• Multiple machines: connect local, LAN, Tailscale, and RunPod hosts, then route work and browse one combined Library.
• Organization: title, favorite, tag, collect, restore, and manage prints across the desktop and web apps.

Model weights keep their own licenses. See each model page for terms and current platform support.

Mold Studio

The desktop app brings Create, Library, Models, Machines, and Settings into one workspace for local and remote generation. It also pairs with the iPhone and Android companions.

Download Mold for macOS (Apple Silicon) · Explore the desktop app

Download Mold for Windows (x86_64) — a self-signed NSIS installer. The published build is CPU / remote-hosts only; see the desktop guide for the CUDA recipe. Verify and explicitly trust the release's mold-windows-self-signing.cert.cer before installing; the certificate is not publicly trusted and does not suppress SmartScreen on its own.

Linux desktop builds are source/CI distributions for now — nix build .#mold-desktop or the devshell's desktop-build CUDA AppImage. See the desktop guide.

Android uses the same remote-only Mold Studio mobile interface. Download the signed universal nightly APK directly; there is no zip to unpack:

Download nightly Android APK · Android installation guide

More ways to create

Preview generations directly in supported terminals:

mold run "a cat" --preview

Inline image generation in Ghostty with --preview

Or open the keyboard-first terminal interface with mold tui:

The TUI Create workspace with a native terminal image preview

Run the engine where the GPU lives and connect from another machine:

mold serve                                      # GPU machine
MOLD_HOST=http://gpu-server:7680 mold run "a cat"  # laptop

See the remote workflow and RunPod guides. Use mold queue to manage remote work and mold library to browse and organize the host's prints. To install Mold's Agent Skill for supported coding agents, run:

mold skill install --detected

The installed bundle uses each agent's native metadata and discovery contract, with a concise router, safety guidance, tested examples, and the prompting corpus: a shared guide, one complete base guide per manifest family (prompt style, syntax, generation context, examples, pitfalls, and that family's CLI examples), task leaves for the distinct H3, Wan, and LTX-2 grammars, and model leaves for checkpoints with quirks of their own. The corpus in crates/mold-core/src/prompting/ is also what mold expand, mold remix, --expand, the app Expand and Remix actions, and the MCP expand_prompt / remix_prompt tools hand to the LLM, together with the exact model, canvas, frame count, fps, and ordered references, so agents and the expander follow one set of rules. Hunyuan3D's base guide is the one that tells an agent NOT to write a prompt.

Project

Mold is a Rust workspace built on candle. The documentation covers the CLI, configuration, deployment, and HTTP API.

Core contributors: James Brink and Jeffrey Dilley.

Licensed under the MIT License. Third-party components and model licenses are listed in THIRD_PARTY_NOTICES.md and the model documentation. InsightFace identity weights require separate acceptance and are limited to non-commercial research use.