Image Generation AI Agents

Generate images from natural language descriptions with PraisonAI Image Agents — sync or async, with DALL-E integration out of the box.

from praisonaiagents import ImageAgent

agent = ImageAgent(llm="dall-e-3")
agent.chat("A minimalist logo for a coffee shop")

The user describes an image; the image agent calls the generation API and returns a URL.

How It Works

Quick Start

Simple Usage

import os
from praisonaiagents import ImageAgent

agent = ImageAgent(llm="dall-e-3")
result = agent.chat("A cute baby sea otter playing with a laptop")
print(result)

Set OPENAI_API_KEY in your environment before running.

With Configuration

import os
from praisonaiagents import ImageAgent

agent = ImageAgent(
    name="ImageCreator",
    llm="dall-e-3",
    style="natural",
)

result = agent.chat("A minimalist logo for a coffee shop")
print(result)

Async

import asyncio
import os
from praisonaiagents import ImageAgent

async def main():
    agent = ImageAgent(name="ImageCreator", llm="dall-e-3", style="natural")
    result = await agent.achat("A cute baby sea otter playing with a laptop")
    print(result)

asyncio.run(main())

achat() is genuinely non-blocking as of PR #5219 — the image round-trip runs on a worker thread, not the event loop. See Non-blocking async below.

Install with LLM support: pip install "praisonaiagents[llm]"

Non-blocking async (PR #5219)

ImageAgent.agenerate_image, agenerate, aedit, avariation, and (transitively) achat now offload the synchronous image call via asyncio.to_thread, so awaiting one no longer freezes the event loop for the 10–60 second image round-trip. Reference: PR #5219, fixes #5162. Run an ImageAgent and a text-only Agent side by side — the text agent keeps streaming while the image generates:

import asyncio
from praisonaiagents import Agent, ImageAgent

img_agent = ImageAgent(name="ImageCreator", llm="dall-e-3", style="natural")
text_agent = Agent(name="Writer", instructions="Write a short product blurb.")

async def main():
    # Before PR #5219 the image call ran inline on the loop thread and
    # silently starved the text agent for the whole 10–60s round-trip.
    # Now both run concurrently.
    image, blurb = await asyncio.gather(
        img_agent.achat("A minimalist logo for a coffee shop"),
        text_agent.achat("Describe a cozy neighbourhood coffee shop"),
    )
    print(image)
    print(blurb)

asyncio.run(main())

This fix landed for ImageAgent only. VideoAgent (astart, adownload) and AudioAgent (atranscribe) still run their synchronous call inline on the event loop as of PR #5219 and will block a concurrent gather. If a follow-up PR offloads them, this warning will be updated.

Features

DALL-E Integration

Seamless integration with DALL-E for high-quality image generation.

Async Support

Asynchronous operations for better performance in concurrent environments.

Natural Style

Generate images with natural, realistic styling options.

Verbose Mode

Detailed output logging for better debugging and monitoring.

Best Practices

Use environment variables for API keys

Read OPENAI_API_KEY from the environment — never hardcode keys in source files.

Pick the right model

Use dall-e-3 for quality; switch models via the llm parameter when cost or speed matters more.

Prefer async in web apps

Use achat() when serving multiple concurrent image requests from a FastAPI or gateway handler.

Describe style explicitly

Pass style="natural" or include style cues in the prompt for consistent visual output across runs.

Multimodal

Text, image, and audio processing with agents

Outbound Media Delivery

Deliver generated images to users via messaging bots

Async Safety

How blocking calls are offloaded to keep the event loop responsive

Getting Started

Install

Core Concepts

Guides

Features

Models

Databases

Observability

Memory

Telemetry & Analytics

Knowledge

RAG

Persistence

Tools

Other Features

Developers

Configuration

Best Practices

Getting Started (No Code)

Image Generation AI Agents

How It Works

Quick Start

Non-blocking async (PR #5219)

Features

DALL-E Integration

Async Support

Natural Style

Verbose Mode

Best Practices

Multimodal

Outbound Media Delivery

Async Safety

​How It Works

​Quick Start

​Non-blocking async (PR #5219)

​Features

DALL-E Integration

Async Support

Natural Style

Verbose Mode

​Best Practices

​Related

Multimodal

Outbound Media Delivery

Async Safety

How It Works

Quick Start

Non-blocking async (PR #5219)

Features

Best Practices

Related