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.