DandreYang/local-image-gen
DandreYang/local-image-gen has 61 GitHub stars and 9 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-18 09:18 UTC. Last push 2026-08-31.
实测星标增长
- 24小时
- 0
- 7天
- 正在收集历史
- 15天
- 正在收集历史
- 1个月
- 正在收集历史
各周期内的星标净变化,周期相互重叠,并非每日新增。缺失的测量保持空白。星标代表关注度,不代表软件质量。
关于
Generate images from local Grok, Antigravity, Cursor, or Codex logins, with official API keys as fallback.
创作与媒体README.zh-CN.md
原文
local-image-gen
用本机已经登录的编程助手订阅来生图、改图。
官方 API Key 只是兜底,不是前提。
Python 3.9+,只用标准库。既可以当 CLI,也可以当 Claude / Codex / Grok / Cursor / Gemini 等助手的 portable skill(SKILL.md)。
为什么做这个
多数生图 skill 一上来就要付费 Key。如果你已经 grok login、codex auth login、装了 Antigravity agy,或登录过 cursor-agent,那次登录就应该能用。这个项目先走本地订阅,再走对应官方 API。
仓库不会内置非官方中转。API Key 路径默认只打官方地址:
| 供应方 | 官方默认 |
|---|---|
| xAI / Grok Key | https://api.x.ai/v1 |
| OpenAI | https://api.openai.com/v1 |
| Gemini Key | https://generativelanguage.googleapis.com/v1beta |
只有你显式设置 --base-url 或 XAI_BASE_URL / OPENAI_BASE_URL / GEMINI_BASE_URL 时才会改地址。
使用前请读
- 这是给你自己的登录或自己的官方 Key 用的本地编排,不是免费生图网关。
- 生图会消耗你所选后端的配额或账单。
codex供应方是实验项:复用~/.codex/auth.json打未公开的 ChatGPT Codex 生图接口。它可能随时失效,也可能与 OpenAI 条款冲突。需要受支持的gpt-image-2时,请用--provider openai加OPENAI_API_KEY。- 使用订阅通道前,请自行阅读 xAI、OpenAI、Google、Cursor 的服务条款。
安装
一条命令。会克隆或更新到 ~/.local/share/local-image-gen,把 local-image-gen 放到 PATH,并链到本机已有的编程助手(Codex、Claude、Cursor、Grok、Gemini、Trae、Hermes、DeepSeek Harness、OpenCode,以及共享的 Agents 目录):
curl -fsSL https://raw.githubusercontent.com/DandreYang/local-image-gen/main/install.sh | bash
local-image-gen doctor
如果 ~/.local/bin 不在 PATH 里,安装脚本会打印需要加的那一行 export。
带标签的发布: v0.1.5(全部 Release)。
已经 clone 过的话,在仓库里跑 ./install.sh 会用当前目录,不会再下一份。安装脚本只建符号链接,不会覆盖已有的实体 skill 目录。
已经装过:
local-image-gen doctor # 后端、Dyro,以及 main 是否更新
local-image-gen update # git pull --ff-only,再刷新包装脚本和 skill 链接
update 遇到脏工作区、读不了 git status、不是 git 仓库、origin 不是官方 GitHub、或不在 main/master 会拒绝。它只跑 git pull --ff-only origin main。不会再跑 curl | bash。生图命令不会去 GitHub 查新版本。LOCAL_IMAGE_GEN_SKIP_UPDATE_CHECK=1 会跳过 doctor 的新鲜度 GET(Dyro 的 5 秒 spawn 应设置此项)。
可选的 Dyro
这个项目不依赖 Dyro,仍然是独立的 CLI 和 skill。
如果在 Dyro 工作区里运行(上级目录有 dyro.toml),又没传 -o / --out-dir,图片会写到 <workspace>/outputs/images,避免落到 repositories/ 或任务 worktree 里。-o 始终优先。
local-image-gen doctor 会报告后端、是否检测到 Dyro CLI / 工作区,以及这份安装是否落后于 main。不会真正生图。--doctor 是别名。
用法
python3 scripts/local_image_gen.py --list-providers
python3 scripts/local_image_gen.py --list-models
python3 scripts/local_image_gen.py "极简科技封面,无文字" \
--aspect-ratio 16:9 --quality high --optimize auto -o outputs/cover.png
python3 scripts/local_image_gen.py "电影感城市夜景" \
--provider grok --model grok-imagine-image-2.0 \
--aspect-ratio 16:9 --resolution 2k --quality medium -o outputs/city.png
python3 scripts/local_image_gen.py "水彩狐狸在雪林里" \
--provider agy --model gemini-3.1-flash-image \
--aspect-ratio 3:4 --resolution 2k -o outputs/fox.png
python3 scripts/local_image_gen.py "干净的产品静物" \
--provider openai --model gpt-image-2 --aspect-ratio 1:1 -o outputs/still.png
python3 scripts/local_image_gen.py doctor
python3 scripts/local_image_gen.py "test" --dry-run --aspect-ratio 1:1
已安装该 skill 的助手应直接运行 scripts/local_image_gen.py,不要只给命令建议。
供应方
--provider |
默认模型 | 订阅 / CLI | 官方 API Key |
|---|---|---|---|
auto |
自动选择 | 是 | 是 |
grok |
grok-imagine-image-2.0 |
grok login |
XAI_API_KEY |
agy / antigravity |
gemini-3.1-flash-image |
本地 agy |
— |
cursor |
gemini-3-pro-image |
本地 cursor-agent |
— |
gemini |
gemini-3.1-flash-image |
Nano Banana:Antigravity → Cursor → Key | GEMINI_API_KEY |
codex |
gpt-image-2 |
实验性 codex auth login |
—(请用 openai) |
openai |
gpt-image-2 |
— | OPENAI_API_KEY |
xai |
grok-imagine-image-2.0 |
— | XAI_API_KEY |
未点名模型族时,auto 优先 Grok,然后 Codex,再 Antigravity(agy),再 Cursor。点名 Nano Banana 时仍是 Antigravity → Cursor → GEMINI_API_KEY。当前 harness 已登录且可用时,仍优先走当前 harness。
参数对照见 references/providers.md。模型清单以 --list-models 为准。
提示词
多数人和多数编程助手不会写生产级生图提示词。CLI 不会默认改写你的原文。
| 参数 | 作用 |
|---|---|
--raw |
原文直送 |
--prompt-profile cover|poster|portrait|product|edit |
用确定性模板包一层,不调文本模型 |
--optimize auto |
短/空泛提示词会编译;上一张图若是另一家的成品提示词,也会按目标家族重适配。同族文本模型(grok login 或官方 Key),冻结系统提示,无工具,不拉起 agy / cursor-agent |
--optimize on |
总是按目标家族编译;--raw 和 --provider codex 除外。Imagine 与 Nano Banana 互转要用这个 |
--optimize off |
默认。原文传输 |
--dry-run --optimize auto 可以只打文本模型,看 JSON 里的 prompt.used,不消耗生图配额。每次结果都带 prompt.original / prompt.used / prompt.optimize。省略 -o 时,默认文件名的 hash 用的是原文。
--mask 只支持官方 OpenAI Images 局部重绘(--provider openai)。Grok Imagine 编辑最多 3 张参考图。
配置
Key 和可选自定义 base,进程环境之后按下面顺序取第一个:
--api-key-file./.env~/.local-image-gen.env~/.config/local-image-gen.env
参考 .env.example。不要提交真实 env 文件。
单次覆盖用 --base-url / --api-base。订阅通道忽略自定义 base,继续走官方登录入口。
开发
python3 tests/test_local_image_gen.py
python3 tests/test_prompt_compile.py
python3 scripts/local_image_gen.py --version
python3 scripts/local_image_gen.py doctor
没有第三方 Python 依赖。
许可证
相关兄弟项目
DyroEngineeringFlow(dyro)是可选的第一方交付控制面。同屋不是同一产品:本 CLI 不依赖它,装其中一个也不会装上另一个。如果已经在 Dyro 工作区里,省略 -o / --out-dir,图片会写到 <workspace>/outputs/images。