apx-image

Generate images from text prompts via routed local, LAN, or cloud diffusion engines.

6|1|Updated May 8, 2026
One-click install
npx skills add https://github.com/agentprojectcontext/apx --skill apx-image-agentprojectcontext
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: apx-image
Source: https://github.com/agentprojectcontext/apx/tree/main/src/core/runtime-skills/apx-image
Command: npx skills add https://github.com/agentprojectcontext/apx --skill apx-image-agentprojectcontext

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a text prompt into an image file normally means knowing which diffusion server is running, which dialect its API speaks, and which sampling settings its checkpoint needs. This Skill routes a single apx image command to whichever engine is configured and reachable, so the caller never manages endpoints, dialects, or per-engine defaults. ## Core Features & Use Cases - Multi-engine routing: Tries engines in a configured order (AUTOMATIC1111/Forge/Draw Things, stable-diffusion.cpp, OpenAI-compatible cloud, mock) and skips unreachable servers instead of failing. - Layered option resolution: Merges global defaults, per-engine defaults, and per-call flags like size, steps, guidance, seed, and negative prompt, so checkpoint-specific settings live with the engine. - Ignored-option reporting: Reports which options an engine could not honor (e.g. seed or negative prompt on the OpenAI dialect) instead of silently dropping them. - Use Case: Ask for a logo sketch with a fixed seed and specific dimensions; the command routes to the local A1111 server, applies that engine's step and guidance defaults, writes the PNG to ~/.apx/images/, and prints the file path. ## Quick Start Ask the agent to generate an image of a green origami fox on a white background and save it to a file using the apx image command.

Frequently Asked Questions about apx-image

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate an image from a text prompt with apx?▼

Run `apx image "your prompt"` and the command routes to the first reachable configured engine. Without `--out`, the file is saved under `~/.apx/images/<date>/` and the path is printed on stdout.

Which image generation engines does apx image support?▼

It supports the a1111 dialect (AUTOMATIC1111, Forge, SD.Next, Draw Things), stable-diffusion.cpp's native job queue, OpenAI-compatible cloud endpoints, and a mock engine for offline testing. Custom endpoints can be added under `images.custom.<slug>`.

Can I use Ollama to generate images with apx?▼

No. Ollama serves language and vision models and cannot generate images. On macOS, point the a1111 engine at Draw Things' HTTP API or any local A1111-compatible server instead.

Why is my seed or negative prompt being ignored?▼

The OpenAI dialect has no steps, guidance, sampler, seed, or negative prompt support. After each run, check the `ignored` field in `--json` output to see which options the engine could not honor.

How do I set default steps and guidance for a specific engine?▼

Set them under `images.<engine>.defaults` in `~/.apx/config.json`, for example with `apx config set --global images.a1111.defaults '{"steps":8,"cfg_scale":1}'`. Steps and guidance belong to the engine because the right values depend on the loaded checkpoint.