Draw Things CLI
Overview
`draw-things-cli` is a reboot of Draw Things' internal CLI, which had fallen out of maintenance as the GUI app matured. It is claimed to be the fastest image generation tool on macOS. (source: draw-things-cli.md)
It is fully open-source under the GPL-v3 license, built from the same inference stack that powers the Draw Things iOS/macOS app.
Installation
Via Homebrew:
```bash brew install drawthingsai/draw-things/draw-things-cli ```
Building from source is also supported. (source: draw-things-cli.md)
Features
- Shell auto-completion
- Direct image output in the terminal
- Automatic model downloads when a model is needed
- Recommended settings pulled from the community repository when available
(source: draw-things-cli.md)
Usage with Z-Image Turbo
Pass model settings via `--config-json`. The `sampler` field takes an integer ID, not a string — see Draw Things CLI — Sampler Integer IDs for the full table.
Optimal settings for Z-Image Turbo:
```json { "steps": 8, "guidanceScale": 1, "sampler": 15, "width": 1024, "height": 1024 } ```
`"sampler": 15` is DDIM Trailing (project preference). The community catalog default is `17` (UniPC AYS). Load keys before running: `set -a; source .secrets.env; set +a`.
Related projects
- `gRPCServerCLI`: A separate binary from the `draw-things-community` public GitHub repo. Available for both macOS and NVIDIA platforms. Built from the same core inference stack under GPL-v3.
- `draw-things-community`: The public GitHub repository (`drawthingsai/draw-things-community`) containing the core inference stack.
Notes
The source article was clipped early and ends at the installation step. Additional details on flags, model selection, and advanced usage examples are not yet captured here. (source: draw-things-cli.md)