tlnw-generate-image 0.2.0

Generate illustrations and images dynamically using OpenAI DALL-E and Google Imagen models.

Tellers Network Image Generation Tool (tlnw-generate-image)

tlnw-generate-image is a standalone, publishable package that unifies AI image generation for stories and posts in the Tellers Network ecosystem. It supports OpenAI (DALL-E 2, DALL-E 3, and legacy gpt-image-1.5) as well as Google Gemini Imagen 4 models.

Installation

pip install tlnw-generate-image

Features

• Extensible OOP Provider Architecture: Clean separation of model providers (DalleProvider, GptImageProvider, GoogleImagenProvider) with registry-based dynamic routing.
• Intelligent Size & Quality Preset Mapping: Standardizes orientation presets (landscape, portrait, square) and qualities, automatically converting them to provider-native formats: aspect ratios (e.g. "16:9") for Google Imagen, or concrete dimensions (e.g. "1792x1024") for OpenAI.
• Custom Dimension Resolution: Automatically maps exact resolution values (e.g., 1920x1080 or 1536x1024.txt in file names) to the closest supported native aspect ratios when routing to Imagen, while passing OpenAI dimensions as-is.
• Auto-resolution of Output Sizing: Extracts target sizes from prompt filename trailing suffixes (e.g., -1536x1024.txt).
• Prompt Composition: Concatenates local directory illustration-master-prompt.txt automatically with individual scene prompts.
• Automatic WebP Conversion: Generates and optimizes WebP formats (featured.webp and thumbnail.webp with max-dimension constraints).
• Automated Jekyll/Hugo Updating: Automatically updates the article frontmatter's images block.

Usage

Generate illustration for a story folder:

generate-image /path/to/story_folder --model dall-e-3

Process specific prompt files:

generate-image --file /path/to/prompt-1536x1024.txt --model imagen-4-ultra