← Back to Skills Marketplace
imgforge — Free AI Image Generation
by
Futurize Rush
· GitHub ↗
· v1.1.0
· MIT-0
226
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install imgforge
Description
Generate AI images for free using Z-Image-Turbo. Say "generate an image of..." and get stunning results in seconds.
README (SKILL.md)
Z-Image — Free AI Image Generation
Generate images from text using Alibaba's open-source Z-Image-Turbo model. Free to use.
When to Trigger
Activate this skill when the user asks to:
- generate, create, draw, or make an image / picture / illustration / photo
- create thumbnails, avatars, banners, or social-media graphics
- visualize a concept, scene, or character
Generating an Image
python3 SKILL_DIR/imgforge.py "PROMPT" -o OUTPUT_PATH
Arguments
| Flag | Default | Description |
|---|---|---|
PROMPT (positional) |
— | Text description (English or Chinese) |
-o, --out |
output.jpg |
File path to save the image |
-W, --width |
1024 | Width in pixels (512–2048) |
-H, --height |
1024 | Height in pixels (512–2048) |
--json |
off | Output result as JSON |
Common sizes
| Aspect | Flags |
|---|---|
| Square (1:1) | -W 1024 -H 1024 |
| Landscape (16:9) | -W 1280 -H 720 |
| Portrait (9:16) | -W 720 -H 1280 |
| Wide banner | -W 2048 -H 1024 |
Prompt tips
Add quality keywords for better output: "4K", "cinematic", "professional photography", "dramatic lighting", "shallow depth of field".
Specify a style: "oil painting", "watercolor", "anime", "pixel art", "minimalist vector".
Environment
Requires MODELSCOPE_API_KEY. If the user hasn't set it, guide them:
- Create a free Alibaba Cloud account (phone verification + payment method required, but Z-Image is free) → https://www.alibabacloud.com/campaign/benefits?referral_code=A9242N
- Sign up at https://modelscope.ai/register?inviteCode=futurizerush&invitorName=futurizerush&login=true&logintype=register and bind the Alibaba Cloud account in settings
- Create a token at https://modelscope.ai/my/access/token
- Set the environment variable:
export MODELSCOPE_API_KEY="ms-..."
For Claude Code users, add to ~/.claude/settings.json under "env".
Errors
| Symptom | Cause & fix |
|---|---|
| 401 Unauthorized | Token is from modelscope.cn (wrong site) — must use modelscope.ai. Or Alibaba Cloud account not bound. |
| Timeout after 150s | API under load — retry in a minute |
| Content moderation | Rephrase the prompt — Alibaba's filter blocked it |
Notes
- No external dependencies required (uses Python stdlib). Pillow is optional for format conversion.
- The script creates parent directories automatically.
- Image URLs from the API expire in 24h — the script downloads immediately.
Usage Guidance
This skill appears to do what it says: it uses your MODELSCOPE_API_KEY to call ModelScope's image-generation API and saves the returned image. Before installing, verify you trust ModelScope (api-inference.modelscope.ai) and the GitHub source (homepage points to a repo). Be aware that creating the ModelScope setup may require binding an Alibaba Cloud account (phone verification and a payment method on file). Treat your MODELSCOPE_API_KEY as a secret (it will be transmitted in Authorization headers to ModelScope) — use a dedicated token you can revoke if needed. If you want extra caution, review the included imgforge.py (simple, stdlib HTTP code) and consider running it locally rather than granting any automated agents persistent access.
Capability Analysis
Type: OpenClaw Skill
Name: imgforge
Version: 1.1.0
The 'zimage' skill is a legitimate tool for generating AI images via the ModelScope API. The core logic in 'imgforge.py' uses standard Python libraries to interact with the official ModelScope inference endpoint and contains no evidence of malicious behavior, data exfiltration, or unauthorized command execution. While the documentation and setup instructions include referral codes for Alibaba Cloud and ModelScope registration, these are transparently presented and do not pose a security risk.
Capability Tags
Capability Assessment
Purpose & Capability
Name/description, README, SKILL.md and imgforge.py all describe a text→image client that calls ModelScope's async image-generation API; required binary (python3) and required env var (MODELSCOPE_API_KEY) are consistent with that purpose.
Instruction Scope
Runtime instructions only invoke the included python script and describe how to obtain/set MODELSCOPE_API_KEY. The script contacts api-inference.modelscope.ai, downloads the returned image URL and saves it locally. The instructions do not request unrelated files, credentials, or external endpoints.
Install Mechanism
No install spec; code is bundled as a small Python script and optional Pillow dependency. No arbitrary downloads or extract-from-URL steps are present in the package metadata.
Credentials
Only MODELSCOPE_API_KEY is required, which is appropriate. Note: README and SKILL.md instruct users to bind an Alibaba Cloud account (phone verification and a payment method are required by Alibaba even if ModelScope usage is free); the bearer token will be sent to modelscope.ai (expected) so treat it as sensitive.
Persistence & Privilege
Skill is not always-enabled and is user-invocable. disable-model-invocation is false (normal platform default); the skill does not modify other skills or system-wide settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install imgforge - After installation, invoke the skill by name or use
/imgforge - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.0
Update ModelScope sign-up links.
v1.0.0
Initial release.
Metadata
Frequently Asked Questions
What is imgforge — Free AI Image Generation?
Generate AI images for free using Z-Image-Turbo. Say "generate an image of..." and get stunning results in seconds. It is an AI Agent Skill for Claude Code / OpenClaw, with 226 downloads so far.
How do I install imgforge — Free AI Image Generation?
Run "/install imgforge" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is imgforge — Free AI Image Generation free?
Yes, imgforge — Free AI Image Generation is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does imgforge — Free AI Image Generation support?
imgforge — Free AI Image Generation is cross-platform and runs anywhere OpenClaw / Claude Code is available (macos, linux, windows).
Who created imgforge — Free AI Image Generation?
It is built and maintained by Futurize Rush (@futurizerush); the current version is v1.1.0.
More Skills