← Back to Skills Marketplace
971
Downloads
1
Stars
13
Active Installs
5
Versions
Install in OpenClaw
/install free-image-generation-skill
Description
Professional free image generation skill for agents. No API key required. Generate images from text with resilient retry/backoff and clean local file output....
README (SKILL.md)
Free Image Generation Skill
No API key required.
Run a clean production workflow:
- install dependencies,
- generate image from prompt,
- save output.
Quick Start (Fresh Setup)
- Install dependencies:
bash scripts/setup_env.sh
- Generate one image:
python3 scripts/perchance_generate.py \
--prompt "cinematic isometric office, dusk, neon reflections" \
--out ./media/free-image-sample.jpg \
--shape square
Reliability Rules
- Default retries: 3
- Backoff: built into script
- On failure, return exact
errorand propose retry - Designed for free, repeated usage with responsible pacing
- Keep usage responsible and moderate
Parameters
perchance_generate.py supports:
--prompt(required)--out(required)--shape(portrait|square|landscape)--negative--guidance--retries--timeout
Resources
- Main generator:
scripts/perchance_generate.py - Dependency setup:
scripts/setup_env.sh,scripts/requirements.txt
Usage Guidance
This package appears to do what it says: it runs a local Python script that calls an unofficial Perchance image API to generate and save images. Before installing/running: (1) confirm you have a safe Python environment (python3 and pip); (2) review the scripts (they are included) and verify you are comfortable sending prompts to https://image-generation.perchance.org — prompts and generated images will be transmitted to that external service; (3) run in an isolated environment if prompts may contain sensitive data; (4) be aware the service is unofficial and may change or become unavailable; (5) if you need higher assurance, request a skill with a documented homepage/source or an official API provider.
Capability Analysis
Type: OpenClaw Skill
Name: free-image-generation-skill
Version: 1.0.4
The skill's core functionality involves generating images and saving them to a user-specified path. The `scripts/perchance_generate.py` script processes the `--out` argument by resolving the path (`Path(args.out).expanduser().resolve()`) and directly writing the downloaded image content to it. This creates a path traversal/arbitrary file write vulnerability, as an attacker could potentially specify any writable location on the filesystem to overwrite files with image data. While the content written is an image (not directly executable code), this lack of input sanitization or path restriction is a significant vulnerability, classifying the skill as suspicious rather than benign. There is no evidence of intentional malicious behavior such as data exfiltration, persistence, or remote code execution.
Capability Assessment
Purpose & Capability
Name/description (free image generation) align with the included Python script and docs. The skill requires running Python and pip (via scripts/setup_env.sh) even though the registry metadata lists no required binaries—this is a small mismatch but expected for a Python script.
Instruction Scope
SKILL.md instructs installing dependencies and running scripts to generate and save images. The runtime code makes network requests to an unofficial third‑party API (image-generation.perchance.org), extracts a userKey from HTML, posts prompt payloads, and downloads image bytes. The instructions do not read unrelated local files or environment variables and return structured output. The external network calls are expected for this purpose but are worth noting for privacy/availability reasons.
Install Mechanism
No install spec in registry; the bundled setup_env.sh installs the single dependency (requests) via pip --user from the included requirements.txt. This is a low-risk, local install behavior (no arbitrary remote downloads or extract steps).
Credentials
The skill requests no environment variables or credentials, which is proportional. It does, however, contact an unofficial external service (no homepage or authoritative source provided). Consider the privacy implications of sending prompts to that third party and the reliability/trustworthiness of the endpoint.
Persistence & Privilege
The skill does not request always:true, does not modify other skills, and only writes image files to the output path and installs a Python library to the user's environment. No elevated or global agent privileges are requested.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install free-image-generation-skill - After installation, invoke the skill by name or use
/free-image-generation-skill - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.4
Updated listing copy: no API key required, free high-volume usage positioning, refined reliability wording.
v1.0.3
Removed delivery-channel assumptions from docs. Skill is now strictly generation-only; host agent controls delivery.
v1.0.2
Removed human-face fallback path and related flags. Simplified to pure image-generation pipeline with cleaner docs.
v1.0.1
Refined public presentation, removed personal/local path examples, improved onboarding clarity, polished trust-focused documentation.
v1.0.0
Initial release: unofficial Perchance-style free image generation pipeline, setup script, retries/backoff, optional human fallback, Telegram delivery contract.
Metadata
Frequently Asked Questions
What is Free Image Generation Skill?
Professional free image generation skill for agents. No API key required. Generate images from text with resilient retry/backoff and clean local file output.... It is an AI Agent Skill for Claude Code / OpenClaw, with 971 downloads so far.
How do I install Free Image Generation Skill?
Run "/install free-image-generation-skill" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Free Image Generation Skill free?
Yes, Free Image Generation Skill is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Free Image Generation Skill support?
Free Image Generation Skill is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Free Image Generation Skill?
It is built and maintained by ILA IKRAM (@mrilaikram); the current version is v1.0.4.
More Skills