# 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. Supports free, high-volume usage patterns with responsible request pacing. Use when users request prompt-to-image generation or image bot automation.

- Skill: `dvcrn/free-image-generation-skill` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add dvcrn/free-image-generation-skill`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/free-image-generation-skill/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/free-image-generation-skill

---


# Free Image Generation Skill

No API key required.

Run a clean production workflow:
1) install dependencies,
2) generate image from prompt,
3) save output.

## Quick Start (Fresh Setup)

1. Install dependencies:
```bash
bash scripts/setup_env.sh
```

2. Generate one image:
```bash
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 `error` and 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`