Repository navigation
Atelier 0.12.0
Install: download Atelier-0.12.0.zip, open it, and drag Atelier to your Applications folder, replacing any older copy. If you have 0.3 or later, Atelier ▸ Check for Updates… installs it for you. Requires a Mac with Apple silicon running macOS 26 or later.
MiniMax H3 Image
MiniMax H3 Image makes images from a prompt and edits pictures from an instruction, in one model, in 6 steps.
- Guided install. In Models, the MiniMax H3 Image row above the list has Install…. It links to the two Hugging Face downloads (the 40 GB model and the 1.2 GB VAE), then converts them on your Mac: it imports the model, converts the VAE, makes the 21 GB 8-bit S copy, and by default moves the full-precision copy to the Trash. The text encoder (MiniMax H3's) then downloads if you don't have it. Importing the files yourself with Import… works too, VAE included.
- Sizes up to 16 megapixels. For this model the size popover goes up to 16 megapixels (4096×4096). With the 8-bit S copy on a 48 GB Mac, 2048×2048 takes about 40 seconds and 4096×4096 under 2 minutes.
- Editing. Use Edit with the picture on the canvas; moodboard images are sent as further pictures, called
<Picture 1>,<Picture 2>and so on in the prompt. - Tips. It works best with a long, detailed English description of the whole image. When editing a picture it made, use a different seed from the one that made it.
- License. The model's license is the MiniMax-H3-Image Community License, which doesn't cover use in the European Union, the United Kingdom, South Korea or the United States. Atelier doesn't distribute the model; read the license on Hugging Face before you download it.
Guide: Models and LoRAs ▸ MiniMax H3 Image.
Refining part of an image
- Zoom and mask. Zoom and move the image under the frame to work on part of it, and paint a mask with the Brush and Eraser in the status bar. With Merge into Image (on by default) the result goes back into the whole image at its own resolution, blended over Mask Blur; a frame reaching past the image grows it. Results are saved as Draw Things saves a canvas, as layers.
- Select. The Select tool makes the mask for you: Select Subject uses Apple's subject detection, and clicks and boxes use SAM 2.1, which downloads once (93.9 MB for Small). Add, Subtract or Replace puts the selection into the mask; a selection not yet added is added when you generate.
- Masks stay with their images. Each image remembers the last mask it had and gets it back when it returns to the canvas, also after a relaunch. Mask ▸ Replace Canvas Mask / Add to Canvas Mask in History, and Copy Mask / Paste Mask, reuse one image's mask on another. Mask strokes, selections and setting changes share one undo history.
- Agents can do the same through new MCP tools:
set_canvas_image,set_canvas_mask,get_canvas_mask,auto_maskandset_canvas_region, andgeneratewithuse_canvasruns exactly what the Generate button would.
Guides: Creating images ▸ Refining part of an image, MCP ▸ Masks and regions on the canvas.
Also new
- MOSS Image Edit LoRAs. LoRAs from the MOSS Image Edit trainer import like any other LoRA and turn MOSS Image into an edit model, with the canvas and moodboard as references. Single-image edits work well; the released LoRA was trained on single-image edits, so edits combining images usually return the first image unchanged. Guide: Models and LoRAs ▸ MOSS Image Edit LoRAs.
- Load Settings from Image works for images made in Atelier, on the canvas or picked in History, and for any video frame put on the canvas with Use This Frame as Input.