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, gpt-image-2, 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 & Validation: Automatically maps exact resolution values (e.g.,
1920x1080or1536x1024.txtin file names) to the closest supported native aspect ratios when routing to Imagen. Forgpt-image-2, it validates custom resolution constraints locally (divisibility by 16, aspect ratios between 1:3 and 3:1, and a maximum resolution edge of 3840px with a minimum edge of 2160px). - 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.txtautomatically with individual scene prompts. - Automatic WebP Conversion: Generates and optimizes WebP formats (
featured.webpandthumbnail.webpwith max-dimension constraints). - Standardized Output Filenames: Output filenames are derived from the prompt file base:
<prefix>-prompt.txtor<prefix>-prompt-<size>.txtbecome<prefix>.<ext>. - Optional WEBP Copy: Use
--webpto create an additional lossless<prefix>.webpcopy alongside the main output. - Thumbnail Generation: Use
--thumbnailto create<prefix>-thumbnail.webpresized to max 768px with 75% quality.
Usage
Generate illustration for a story folder:
generate-image /path/to/story_folder --model dall-e-3 --webp --thumbnail
Process specific prompt files:
generate-image --file /path/to/prompt-1536x1024.txt --model imagen-4-ultra
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file tlnw_generate_image-0.5.0.tar.gz.
File metadata
- Download URL: tlnw_generate_image-0.5.0.tar.gz
- Upload date:
- Size: 10.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7f87b7b6422b14bdbffe85e84afaacb935075a3eb504ab299ac2981a8b265249
|
|
| MD5 |
8af39e39d030da4bd442b919db5eaa36
|
|
| BLAKE2b-256 |
a9cfaf4b50b27c38c308a363d63c630c91c887af4929f0d3767d8f23fbc5bbaf
|
Provenance
The following attestation bundles were made for tlnw_generate_image-0.5.0.tar.gz:
Publisher:
publish-to-pypi.yml on tellersnetwork/tlnw-generate-image
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
tlnw_generate_image-0.5.0.tar.gz -
Subject digest:
7f87b7b6422b14bdbffe85e84afaacb935075a3eb504ab299ac2981a8b265249 - Sigstore transparency entry: 1977657463
- Sigstore integration time:
-
Permalink:
tellersnetwork/tlnw-generate-image@a06e972abb8d24b9db4257948eeb93c0cbc117c4 -
Branch / Tag:
refs/tags/v0.5.0 - Owner: https://github.com/tellersnetwork
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-to-pypi.yml@a06e972abb8d24b9db4257948eeb93c0cbc117c4 -
Trigger Event:
release
-
Statement type:
File details
Details for the file tlnw_generate_image-0.5.0-py3-none-any.whl.
File metadata
- Download URL: tlnw_generate_image-0.5.0-py3-none-any.whl
- Upload date:
- Size: 8.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
02ccceabdc5ee3f6d7efde9628a88c56ea6f70146979f17e05dea5cebed8a8f6
|
|
| MD5 |
bbb100ae79dc44efa99e1e04b7825a87
|
|
| BLAKE2b-256 |
673d81062f9c6a14b022c10b659d50c94cc54c80f1ccb529ee9d5429665197be
|
Provenance
The following attestation bundles were made for tlnw_generate_image-0.5.0-py3-none-any.whl:
Publisher:
publish-to-pypi.yml on tellersnetwork/tlnw-generate-image
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
tlnw_generate_image-0.5.0-py3-none-any.whl -
Subject digest:
02ccceabdc5ee3f6d7efde9628a88c56ea6f70146979f17e05dea5cebed8a8f6 - Sigstore transparency entry: 1977657544
- Sigstore integration time:
-
Permalink:
tellersnetwork/tlnw-generate-image@a06e972abb8d24b9db4257948eeb93c0cbc117c4 -
Branch / Tag:
refs/tags/v0.5.0 - Owner: https://github.com/tellersnetwork
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-to-pypi.yml@a06e972abb8d24b9db4257948eeb93c0cbc117c4 -
Trigger Event:
release
-
Statement type:
