Tellers Network Tools CLI (tlnw-tools)
tlnw-tools is a modular, dynamic command-line interface (CLI) to manage and run a collection of independent tools in the Tellers Network ecosystem. Each tool is developed as a separate package published to PyPI and registered in tools.yml. When invoked, the main CLI dynamically verifies, downloads (if missing), and executes the tool either in-process (by default) or as a subprocess.
Features
- Dynamic Tool Execution: Run tools registered in
tools.ymldirectly usingtlnw-tools <tool>. - Automatic Packaging Management: Automatically downloads, installs, or updates tools dynamically via
pipon invocation. - Configurable Isolation: Supports executing tools either via in-process module importing or subprocess delegation, configurable on a per-tool basis in
tools.yml. - Consistent CLI: Standard common arguments like
--helpand--debug.
Installation
You can install the main CLI via PyPI:
pip install tlnw-tools
Configuration (tools.yml)
The main CLI registry lies in tools.yml located in the root of the project (or can be customized):
version: 0.1.0
description: "A collection of tools for various tasks and functionalities in the Tellers Network ecosystem."
tools:
- name: "generate-image"
package: "tlnw-generate-image"
execution_mode: "inprocess_import"
module: "tlnw_generate_image.cli"
entry_point: "main"
description: "Generate images and illustrations with OpenAI and Gemini models."
Commands
# General help
tlnw-tools --help
# Running a registered tool (e.g., generate-image)
tlnw-tools generate-image --help
Tool: generate-image
generate-image is the first unified tool package. It integrates and harmonizes image generation capabilities for story folders and specific scenes across both OpenAI (DALL-E 2/3, gpt-image-1.5) and Google Imagen 4.
Usage
tlnw-tools generate-image <story_folders> [options]
Options
--model <model>: Specify model to use. Defaults togpt-image-1.5. Available models:dall-e-3,gpt-image-1.5,imagen-4, etc.--quality <quality>: Normalize quality across OpenAI and Gemini. Choices:low,medium,high,standard,hd,auto.--landscape/--portrait: Control dimensions. Defaults to square (1024x1024).--size: Manually specify dimensions (e.g.,1024x1024).--reference: Supply reference images.--output-prefix: Prepend a custom prefix to generated files.--skip-update: Avoid updating the Jekyll/Hugoindex.mdfrontmatter.
Metadata
Release files for tlnw-tools 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| tlnw_tools-0.1.0.tar.gz | 6.8 kB | With provenance | Details for tlnw_tools-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| tlnw_tools-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for tlnw_tools-0.1.0-py3-none-any.whl |
Total release size: 12.6 kB
Release files / tlnw_tools-0.1.0.tar.gz
| Download URL | tlnw_tools-0.1.0.tar.gz |
|---|---|
| Size | 6.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
75054d64d4e7b1f3a6f3488a5f01a1ba5f750926fb79c8d01a14b72a840d2746
|
|
BLAKE2b-256 checksum How to use checksums |
a50360b40c10e4ca12f0fdfabe6138606c3a77832b05728a195f55a623d45e89
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 13, 2026.
Transparency logRelease files / tlnw_tools-0.1.0-py3-none-any.whl
| Download URL | tlnw_tools-0.1.0-py3-none-any.whl |
|---|---|
| Size | 5.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
baf59505d94df3ca86c146a8c22bcf228f9801f871fcd4933ece598802b8b179
|
|
BLAKE2b-256 checksum How to use checksums |
23c5fdbcdf06242c50c10060c570c101a05c0329afee9fbd6fa550e4a576213b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 13, 2026.
Transparency logSecurity for tlnw-tools 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for tlnw_tools-0.1.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 13, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.