Universal ImageGen Agent CLI
Генерация и правка картинок из любого агента: CLI imagegen-agent и скилл с библиотекой промптов Codex для совместимых API
- 234 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Промпты, входные картинки и заголовки уходят на выбранный адрес Images API, а ключ берется из переменных окружения
- Каждый настоящий запрос тратит деньги на стороне провайдера, поэтому перед ним скилл требует холостой прогон
Установка
- Работает в
Ручная установка
npm install --global universal-imagegen-agentСтавит CLI `imagegen-agent`. Версия 0.1.2 закреплена в README отдельной командой с `@0.1.2`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Промпты, входные картинки и заголовки уходят на выбранный адрес Images API, а ключ берется из переменных окружения
- Каждый настоящий запрос тратит деньги на стороне провайдера, поэтому перед ним скилл требует холостой прогон
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Проект переносит рабочий процесс скилла `imagegen` из Codex на любых агентов, которые умеют запускать команды или Python. CLI `imagegen-agent` создает и правит изображения через OpenAI-совместимый Images API: можно указать свой адрес, модель, заголовки и дополнительные параметры запроса. Рядом лежит скилл `universal-imagegen` с деревом решений по типам задач, правилами написания промптов и неизменяемыми условиями правок, которые закрепляют героя, раскладку, текст и фон. Команды `generate` и `edit` принимают размер, качество, ограничения и несколько входных картинок с маской, а `batch` обрабатывает файл JSONL с заданиями в несколько потоков. Флаг `--dry-run` проверяет запрос без обращения к сети, `--json` печатает машиночитаемый результат. Коды выхода стабильны: 0 успех, 2 ошибка конфигурации или ввода, 1 сбой API, сети или записи. Готовый файл не перезаписывает существующий. Ключ берется только из переменных окружения. Параметра `--api-key` у CLI нарочно нет. Конфигурацию можно положить в `.imagegen.toml`. Для программ есть интерфейсы Node.js и Python. Оригинальный скилл Codex сохранен без изменений в `upstream/imagegen/`.
Для кого. Дизайнерам, маркетологам и разработчикам с агентом в Claude Code или Cursor, которым нужна генерация картинок на своем ключе или совместимом шлюзе.
Подходит, если
- Агент в Claude Code или Cursor должен нарисовать иллюстрацию или макет, а встроенного генератора изображений у него нет
- Фон на готовом изображении надо заменить, не трогая героя, края и текст, поэтому нужны жесткие условия правки
- Для каталога товаров нужна пачка картинок из файла JSONL, которая обрабатывается в несколько потоков
- Открытая модель вроде Qwen-Image развернута у вас, и ее хочется использовать через совместимый шлюз с готовой библиотекой промптов
- Перед платным запросом нужен холостой прогон, который покажет промпт, модель и путь файла
Не подходит, если
- Нужен локальный запуск Qwen-Image через Diffusers, ComfyUI или SGLang: прямых адаптеров под них нет, нужен шлюз или собственный провайдер
- У вас Codex со встроенным инструментом `imagegen`: оригинальный скилл уже подходит, а CLI добавит лишний слой
- Промпты и входные картинки нельзя отправлять внешнему серверу, а доверенного совместимого сервиса нет
Пример запроса к агенту
Сначала сделай холостой прогон: сгенерируй фото керамической кружки для каталога на белом фоне размером 1536x1024, затем создай файл по нормальному запросуОграничения
- Встроен только слой OpenAI-совместимого Images API. Локальные Diffusers, ComfyUI и SGLang для Qwen-Image подключаются через совместимый шлюз либо новый адаптер провайдера.
- Нужен собственный ключ и адрес сервиса. Модель по умолчанию `gpt-image-2.5-sunburst` меняется переменной `IMAGEGEN_MODEL`.
- Выбранный сервер получает промпты, входные картинки и заголовки, поэтому подходят только доверенные адреса.
- Для разработки на Python нужна версия 3.11 или новее, установка через `uv sync --extra dev`.
Как отключить. Удалите CLI командой `npm uninstall --global universal-imagegen-agent` и папку `universal-imagegen` из каталога скиллов агента. Файл `.env` с ключом и `.imagegen.toml` в проекте стираются вручную.
Частые вопросы
Как установить Universal ImageGen Agent?
Выполните `npm install --global universal-imagegen-agent`, затем проверьте `imagegen-agent --version`. Без глобальной установки работает `npx universal-imagegen-agent generate "A ceramic mug" --dry-run --json`.
Как подключить скилл к Claude Code или Cursor?
Выполните `imagegen-agent install-skill --target /путь/к/skills`, указав каталог скиллов агента. По умолчанию скилл идет в `$CODEX_HOME/skills/universal-imagegen`, а `--force` заменяет существующую копию.
Как настроить ключ и сервис?
Задайте `IMAGEGEN_API_KEY`, `IMAGEGEN_BASE_URL` и `IMAGEGEN_MODEL` в окружении или в `.env`. Проект поддерживает любой совместимый Images API, а `imagegen-agent config --json` показывает конфигурацию с замазанным ключом.
Как отредактировать готовое изображение?
Команда `imagegen-agent edit --image input.png --prompt "Change only the background" --constraints "keep the subject unchanged" --out result.png` правит файл с учетом заданных ограничений. Маска и несколько картинок тоже поддерживаются.
Можно ли подключить Qwen-Image?
Да, через OpenAI-совместимый шлюз, развернутый поверх модели, либо через новый адаптер провайдера. Прямых адаптеров под Diffusers, ComfyUI и SGLang в проект пока не встроено.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыСкилл и CLI для генерации и правки изображений через GPT Image 2 и 2.5 с библиотекой готовых промптов
Набор скиллов для агентов, чтобы генерировать и редактировать изображения, видео и звук через сервис muapi.ai и muapi-cli
Claude Image (GPT Image 2)
claude-image
Скилл учит агентов работать с GPT Image 2. Нужен доступ к API OpenAI, который из России без обходных путей недоступен. README на китайском и английском
Скилл и CLI на Rust: агент генерирует и правит картинки через GPT Image 2, делает прозрачный PNG и отвечает в JSON.
Скрипт на Python вызывает API Agnes AI: текст, картинки и видео по описанию, фото или двум ключевым кадрам, с опросом готовности
Плагин рисует и правит картинки в Claude Code через встроенный image_gen локального Codex по входу ChatGPT, без ключа API.
Коротко о README
Документ объясняет происхождение проекта от скилла Codex и перечисляет, что он дает. Затем идут структура каталога, установка через npm и pnpm, настройка API, примеры команд, соглашение для агентов, интерфейсы Node.js и Python и сведения о лицензии.
Бейдж для README
Исходный SKILL.md
--- name: "universal-imagegen" description: "Bring the Codex imagegen workflow, prompt engineering, use-case taxonomy, edit invariants, and prompt library to any general-purpose agent, then generate or edit raster images through a configurable Images API. Supports OpenAI-compatible services and Qwen-Image deployments exposed through compatible gateways." --- # Universal Image Generation Skill > Adapted on 2026-09-24 from the OpenAI Codex `imagegen` skill. The unmodified > source snapshot is preserved under `upstream/imagegen/`. ## Runtime contract This skill does not assume a host-specific built-in image tool. - Preferred execution: the npm/pnpm-installed `imagegen-agent` CLI. - If the global command is unavailable and package execution is allowed, use `npx -y universal-imagegen-agent` or `pnpm dlx universal-imagegen-agent` as the command prefix. - Reuse the bundled Codex-derived prompt library and workflow regardless of which compatible image model serves the request. - Machine-readable execution: always add `--json`. - Safe validation: run with `--dry-run` before a costly or destructive retry. - Credentials: read from environment variables only. Never ask a user to paste a complete API key into chat and never pass a key on the command line. - API portability: model, base URL, headers, and API-key environment variable are configurable. Do not assume one provider's model catalog. - Open models: Qwen-Image and similar deployments can be used when exposed through the bundled OpenAI-compatible interface. For native Diffusers, ComfyUI, SGLang, or another protocol, add a provider adapter rather than changing the agent-facing workflow. - Output safety: do not overwrite existing files unless the user explicitly authorizes replacement and `--force` is supplied. ## Installation Install the CLI and this skill together: ```bash npm install --global universal-imagegen-agent imagegen-agent install-skill ``` Or install only the skill without keeping a global package: ```bash npx universal-imagegen-agent install-skill ``` Restart or reload the host agent after installation. The installer defaults to `$CODEX_HOME/skills/universal-imagegen`, or