IMA AI Image Generator & Photo Generator — Poster, Thumbnail, Logo, Art, Illustration, Product & Social Media Graphic Design
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.
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_imageandimage_to_imageare classified before execution. - If
--model-idis 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:
python3 scripts/ima_runtime_setup.py --installexport IMA_API_KEY="ima_your_key_here"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-jsonwhen setup passes but runtime or catalog access still fails.
Operator References
README.mdcovers first-use paths and canonical entry commands.references/shared/catalog-aware-selection.mddefines the formal live-catalog-aware model-selection contract.references/operations/troubleshooting.mdcovers common failure recovery.capabilities/image/references/parameter-tuning.mdcoverssize,aspect_ratio, andnusage.capabilities/image/references/scenarios.mdcovers prompt-only and reference-image examples.
Read Order
references/README.mdreferences/gateway/entry-and-routing.mdreferences/gateway/workflow-confirmation.mdreferences/shared/model-selection-policy.mdreferences/shared/catalog-aware-selection.mdreferences/shared/error-policy.mdreferences/shared/security-and-network.mdreferences/operations/troubleshooting.mdcapabilities/image/CAPABILITY.mdcapabilities/image/references/parameter-tuning.mdcapabilities/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.jsonandclawhub.jsonare metadata inputs, not the primary narrative docs.
Related skills
- Downloads
- 2.4kAll time
- Security audit
- Review
- Last updated
- 6mo ago
- Current version
- v1.0.14
- License
- MIT-0
