PHPackages                             carmelosantana/coqui-toolkit-images - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Image & Media](/categories/media)
4. /
5. carmelosantana/coqui-toolkit-images

ActiveLibrary[Image & Media](/categories/media)

carmelosantana/coqui-toolkit-images
===================================

AI image generation and library management toolkit for Coqui — generate, preview, tag, categorize, and search images across OpenAI and Ollama backends.

v0.1.4(1mo ago)03211MITPHPPHP ^8.4CI passing

Since Apr 20Pushed 3w agoCompare

[ Source](https://github.com/carmelosantana/coqui-toolkit-images)[ Packagist](https://packagist.org/packages/carmelosantana/coqui-toolkit-images)[ RSS](/packages/carmelosantana-coqui-toolkit-images/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (4)Dependencies (5)Versions (8)Used By (1)

Coqui Toolkit Images
====================

[](#coqui-toolkit-images)

`carmelosantana/coqui-toolkit-images` adds AI image generation and image-library tools to Coqui.

Features
--------

[](#features)

- Text-to-image generation with OpenAI (`gpt-image-1`) and Ollama CLI backends
- Workspace image library with JSON index at `workspace/images/index.json`
- PNG tEXt metadata embedding (prompt, vendor, model, profile, owner, tags, category)
- Low-fidelity colored block previews via `ext-gd` (optional)
- Atomic index writes to prevent corruption
- Workspace path boundary enforcement
- Configurable OpenAI timeout

Tools
-----

[](#tools)

ToolDescription`image_preflight`Check readiness before generation (credentials, model availability)`image_generate`Generate and save an image`image_preview`Render an existing workspace image as a low-fidelity REPL preview`image_library`List, search, get, tag, delete, and inspect saved images`image_config`Inspect the resolved image toolkit configurationREPL Commands
-------------

[](#repl-commands)

When used with Coqui core, the `/image` slash command provides:

```
/image generate  [--model=vendor/model] [--vendor=openai|ollama] [--tags=a,b] [--category=name]
/image preview  [--width=60]
/image list [--profile=name] [--vendor=openai|ollama]
/image search  [--category=name]
/image get
/image tag   [--category=name]
/image delete
/image config

```

Configuration
-------------

[](#configuration)

The toolkit resolves its defaults from Coqui context when available, then environment variables:

VariablePurpose`COQUI_IMAGE_MODEL`Fallback image model in `vendor/model` format`OPENAI_API_KEY`Required for OpenAI image generation`OLLAMA_HOST`Optional local Ollama host hint`COQUI_WORKSPACE`Fallback workspace path when no Coqui context is provided`COQUI_ACTIVE_PROFILE`Fallback active profile name when no Coqui context is providedOpenAI vendor settings (via `openclaw.json` `agents.defaults.imageConfig.vendors.openai`):

- `apiKey` — API key override
- `baseUrl` — API base URL override
- `timeout` — HTTP request timeout in seconds (default: 240)

Fallback model resolution: if no model is configured, the toolkit infers one — preferring `openai/gpt-image-1` when `OPENAI_API_KEY` is set, or `ollama/gemma3` when the Ollama CLI is available.

Default output path:

```
workspace/images/{profile-name}/{file-hint}-{timestamp}.png

```

Generated-image responses and `image_preview` both emit ANSI-colored block previews using the brightness ramp `░ ░ ▒ ▓ █`, so the REPL can show a low-resolution impression of the image without opening an external viewer.

Development
-----------

[](#development)

```
composer install
composer test
composer analyse
```

###  Health Score

43

—

FairBetter than 89% of packages

Maintenance93

Actively maintained with recent releases

Popularity15

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity46

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~2 days

Total

5

Last Release

42d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/597820?v=4)[Carmelo Santana](/maintainers/carmelosantana)[@carmelosantana](https://github.com/carmelosantana)

---

Top Contributors

[![carmelosantana](https://avatars.githubusercontent.com/u/597820?v=4)](https://github.com/carmelosantana "carmelosantana (16 commits)")

---

Tags

openaiimagestoolkitphp-agentscoquiollamaimage-generation

###  Code Quality

TestsPest

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/carmelosantana-coqui-toolkit-images/health.svg)

```
[![Health](https://phpackages.com/badges/carmelosantana-coqui-toolkit-images/health.svg)](https://phpackages.com/packages/carmelosantana-coqui-toolkit-images)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)