---
id: dynamicprompts
version: "0.31.0"
license: unclear
license_treatment: permissive
maintenance: dormant
---

# dynamicprompts — Dynamic prompts templating library for Stable Diffusion

License: permissive · Maintenance: dormant · Downloads: 157.0K/mo

## What it is and what it does

Dynamic Prompts is a templating library that transforms single prompt templates into multiple varied prompts for text-to-image generators. It lets you define variants using curly-brace syntax (e.g., `{red|green|blue}`), reference reusable wildcard files (e.g., `__colors__`), and use Jinja2 for advanced templating. The library can generate prompts randomly or exhaustively (all combinations), making it useful for batch-generating diverse image prompts without manual repetition.

The package depends on jinja2 for template processing and pyparsing for parsing the custom template syntax. It supports Python 3.8 through 3.11 and integrates with the Automatic1111 Stable Diffusion web UI extension. However, the package has been dormant since March 2024, so it receives no active maintenance or updates.

Use it for:

- Generate multiple image prompts from a single template to explore variations without manual rewriting
- Build reusable wildcard libraries (colors, materials, subjects) to compose consistent prompt families
- Exhaustively generate all possible prompt combinations to systematically test image generation outputs
- Integrate prompt templating into batch image generation workflows for Stable Diffusion or similar tools
- Create complex prompts with Jinja2 logic for conditional or computed prompt segments

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Generates varied text prompts for image generators like Stable Diffusion by parsing templates with variants, wildcards, and Jinja2 expressions into multiple concrete prompts.

Yes, if you actively use Stable Diffusion or similar text-to-image generators and need to generate many prompt variations. The low install friction and permissive license make it safe to try. However, the dormant maintenance status means you should verify compatibility with your current image generator version and be prepared to fork or find alternatives if critical bugs emerge. Not recommended if you need active support or expect the package to evolve.

## Install

pip install dynamicprompts
uv add dynamicprompts
poetry add dynamicprompts

## Installing dynamicprompts

Before you install: Low friction install with only jinja2 and pyparsing as runtime dependencies. Package is dormant (876 days since last release in March 2024), so expect no active maintenance or bug fixes going forward.

License in practice: MIT license (permissive) means you can use, modify, and distribute the package freely with minimal restrictions, though you must include the license notice.

Quickstart:

pip install dynamicprompts

from dynamicprompts.generators import RandomPromptGenerator

generator = RandomPromptGenerator()
results = generator.generate("I love {red|green|blue} roses", num_images=5)

Verify before relying:

- Whether the package still works with current versions of Stable Diffusion or other image generators it targets
- Whether the optional extras (magicprompt, attentiongrabber) are still functional or maintained elsewhere
- Active community or alternative maintained forks given the dormant status

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: dormant
- Downloads: 157.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

prompt template generation, stable diffusion prompt builder, text-to-image prompt templating, dynamic prompt variants, wildcard prompt expansion, prompt engineering library, combinatorial prompt generation, prompt-engineering, stable-diffusion, template-generation

[View on SkillFed](https://skillfed.io/packages/dynamicprompts) · [View on PyPI](https://pypi.org/project/dynamicprompts/)