Generate Ai Images

---
name: generate-ai-images
description: "Use when the user needs image generation or image transformation through the IMA Open API, including text-to-image, image-to-image, style transfer, or reference-image continuity, and the agent should use the setup, doctor, and live-catalog-aware runtime in this repo."
category: "AI & Agents"
author: community
version: "1.0.8"
icon: bot
---

# IMA Image AI

## When To Use

Use this repository when the user wants an image output:

- text-to-image
- image-to-image
- style transfer
- continuity via reference image

This repo is image-only. Do not route video generation, audio generation, or non-image tasks here.

## Gateway Contract

- New-machine bootstrap entrypoint: `python3 scripts/ima_runtime_setup.py`
- Environment/self-check entrypoint: `python3 scripts/ima_runtime_doctor.py`
- The official CLI entrypoint is `python3 scripts/ima_runtime_cli.py ...`.
- Always query the live product list before task creation so `attribute_id`, `credit`, `model_version`, and defaults come from the current catalog.
- Return remote HTTPS image URLs; do not download results into local attachments for the user.
- Route requests through the image capability so `text_to_image` and `image_to_image` are classified before execution.
- If `--model-id` is omitted, the runtime uses the recommended default model for that task type.
- Auto-selected defaults are operational fallbacks, not persisted user preferences.

## Quick Start

- Minimal path:
  1. `python3 scripts/ima_runtime_setup.py --install`
  2. `export IMA_API_KEY="ima_your_key_here"`
  3. `python3 scripts/ima_runtime_cli.py --task-type text_to_image --prompt "a cinematic mountain sunset" --output-json`
- Use `python3 scripts/ima_runtime_doctor.py --output-json` when setup passes but runtime or catalog access still fails.

## Operator References

- `README.md` covers first-use paths and canonical entry commands.
- `references/shared/catalog-aware-selection.md` defines the formal live-catalog-aware model-selection contract.
- `references/operations/troubleshooting.md` covers common failure recovery.
- `capabilities/image/references/parameter-tuning.md` covers `size`, `aspect_ratio`, and `n` usage.
- `capabilities/image/references/scenarios.md` covers prompt-only and reference-image examples.

## Read Order

1. `references/README.md`
2. `references/gateway/entry-and-routing.md`
3. `references/gateway/workflow-confirmation.md`
4. `references/shared/model-selection-policy.md`
5. `references/shared/catalog-aware-selection.md`
6. `references/shared/error-policy.md`
7. `references/shared/security-and-network.md`
8. `references/operations/troubleshooting.md`
9. `capabilities/image/CAPABILITY.md`
10. `capabilities/image/references/parameter-tuning.md`
11. `capabilities/image/references/scenarios.md`

## Boundary

- `references/gateway/*` covers entry, routing, and clarification seams.
- `references/shared/*` covers rules reused across the runtime.
- `capabilities/image/*` owns image-specific behavior.
- `_meta.json` and `clawhub.json` are metadata inputs, not the primary narrative docs.