Creator Factory Core

一个本地优先的 Python 图片任务引擎：SQLite 队列、独立 Worker、确定性的 Mock Provider、可选的 OpenAI Images Provider、本地资产清单、CLI 和 STDIO MCP。它没有网站、远程服务器、消息代理、MySQL，也不依赖现有的私有 AI Creator 应用程序。

中文简介：这是一个可独立运行的通用图片任务核心。默认只使用 Python、SQLite 和本地文件；Mock Provider 可在完全离线的 CI 中生成确定性的合法 PNG。真实 OpenAI 请求必须显式选择 openai Provider，并通过环境变量提供密钥。

快速开始

python -m pip install -e ".[mcp]"
creator-factory init
creator-factory submit "a fictional blue cube" --provider mock --count 2
creator-factory-worker --once
creator-factory status JOB_ID
creator-factory assets --job-id JOB_ID

运行时文件默认存放在 .creator-factory/ 下，并被 Git 忽略。

Related MCP server: openai-image-gen

OpenAI Images Provider

该可选 Provider 使用官方 Image API 生成端点，默认模型为 gpt-image-2，并且只从进程环境中读取 OPENAI_API_KEY：

set OPENAI_API_KEY=...
creator-factory submit "a fictional editorial illustration" --provider openai
creator-factory-worker --once

该密钥绝不会通过 CLI/MCP 参数接收，不会存储到 SQLite，也不会写入日志。CI 永远不会发送真实请求。使用真实 Provider 的作业会在网络执行前被标记；如果其 Worker 被中断，该作业会变为 interrupted_no_retry，需要人工检查/手动重新提交，以避免意外的重复计费。

MCP 工具

• creator_submit_image

• creator_job_status

• creator_job_cancel

• creator_job_retry

• creator_assets_list

• creator_asset_get

提交是异步的，并返回 creator.job.v1；资产行使用 creator.asset_manifest.v1。将 creator-factory-mcp 作为本地 STDIO 服务器运行，并让 creator-factory-worker 作为独立进程运行。

安全

除非选择了 openai Provider，否则提示词和输出都只保留在本地。未经授权，请勿提交机密提示词或第三方个人数据。生成的输出仍需人工审核权利、准确性和政策合规性。

使用 MIT 许可证。