drawthings

# DrawThings Image Generation

Generate images using DrawThings, a local Stable Diffusion implementation for Mac with MLX/CoreML acceleration. DrawThings exposes an Automatic1111-compatible API for programmatic image generation.

## When to Use

Use this skill when you need to:
- Generate images from text prompts
- Create variations of a concept
- Batch generate multiple images
- Test different models/samplers/settings
- Generate images with specific dimensions or quality settings

## Configuration

Set the `DRAWTHINGS_URL` environment variable (defaults to http://127.0.0.1:7860):

```bash
export DRAWTHINGS_URL="http://127.0.0.1:7860"
```

Or configure in OpenClaw:
```bash
openclaw config set env.DRAWTHINGS_URL "http://127.0.0.1:7860"
```

## Quick Start

Generate a single image:
```bash
python3 scripts/generate.py "a cyberpunk cat in neon city"
```

With custom settings:
```bash
python3 scripts/generate.py "a cyberpunk cat" \
  --steps 20 \
  --cfg-scale 7.5 \
  --width 768 \
  --height 768 \
  --sampler "DPM++ 2M Karras"
```

Batch generation (5 variations):
```bash
python3 scripts/generate.py "a fantasy landscape" --batch-size 5
```

Save to specific location:
```bash
python3 scripts/generate.py "portrait photo" --output ./outputs/portrait.png
```

## API Usage

The skill provides a Python script that wraps the DrawThings API (Automatic1111-compatible):

**Main endpoint:** `POST /sdapi/v1/txt2img`

**Common parameters:**
- `prompt` - Text description of the image
- `negative_prompt` - What to avoid in the image
- `steps` - Number of diffusion steps (8-50, default: 20)
- `sampler_name` - Sampler algorithm (default: "DPM++ 2M Karras")
- `cfg_scale` - Classifier-free guidance scale (1.0-20.0, default: 7.0)
- `width` / `height` - Image dimensions (default: 512x512)
- `batch_size` - Number of images to generate (default: 1)
- `seed` - Random seed for reproducibility (-1 for random)

See `references/api-reference.md` for complete API documentation.

## Presets

**Fast...