IMA Image Generator

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.

Safety Notice

This listing is from the official public ClawHub registry. Review SKILL.md and referenced scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "IMA Image Generator" with this command: npx skills add allenfancy-gan/ima-image-ai

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.

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Open Registry RecordOpen in ClawHub