Bratification

Generate brat-style images from text using the bundled Python scripts.

Quick start

• For a plain render, run scripts/render_brat.py.
• For command-style parsing like !brat hello world, run scripts/handle_brat_command.py.
• Prefer white background, Arial Narrow bold (with cross-platform font fallback), centered composition, word wrapping without cutting words, and automatic font shrink to fit.
• handle_brat_command.py now sanitizes slug/output naming and always writes into its managed scripts/out directory tree.

Workflow

1. Decide whether the request is direct text rendering or !brat command parsing.
2. Use scripts/handle_brat_command.py for command-style input.
3. Use scripts/render_brat.py for direct text-to-image rendering.
4. For WhatsApp-safe sticker-like delivery, prefer --size 512 --sticker-size 512 and send the generated PNG with no caption.
5. Treat WEBP as an optional artifact unless the channel has verified native sticker upload support.

Commands

Render text directly

python scripts/render_brat.py "hello world" --png out/hello-world.png --webp out/hello-world.webp

Parse a !brat command

python scripts/handle_brat_command.py "!brat hello world"

Sticker-like WhatsApp-safe output

python scripts/handle_brat_command.py --size 512 --sticker-size 512 "!brat hello world"

Output handling

• Use PNG as the primary reliable delivery format.
• Use WEBP as a secondary artifact for future native-sticker-capable channels.
• If the input is only !brat with no text, ask briefly for the text.
• If generation fails, apologize briefly and say the brat render failed.

Scripts

• scripts/render_brat.py: deterministic renderer for PNG/WEBP output
• scripts/handle_brat_command.py: parser for !brat-style input that emits JSON with generated paths