Creator Factory Core

A local-first Python image task engine: SQLite queue, independent worker, deterministic Mock Provider, optional OpenAI Images Provider, local asset manifests, CLI, and STDIO MCP. It has no website, remote server, message broker, MySQL, or dependency on an existing private AI Creator application.

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

Quick start

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

Runtime files live under .creator-factory/ by default and are ignored by Git.

Related MCP server: openai-image-gen

OpenAI Images Provider

The optional provider uses the official Image API generation endpoint, defaults to gpt-image-2, and reads only OPENAI_API_KEY from the process environment:

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

The key is never accepted in CLI/MCP arguments, stored in SQLite, or written to logs. CI never sends a real request. A real-provider job is marked before network execution; if its Worker is interrupted, the job becomes interrupted_no_retry and requires inspection/manual resubmission to avoid accidental duplicate billing.

MCP tools

• creator_submit_image

• creator_job_status

• creator_job_cancel

• creator_job_retry

• creator_assets_list

• creator_asset_get

Submission is asynchronous and returns creator.job.v1; asset rows use creator.asset_manifest.v1. Run creator-factory-mcp as a local STDIO server and keep creator-factory-worker as a separate process.

Safety

Prompts and outputs stay local unless the openai provider is selected. Do not submit confidential prompts or third-party personal data without authorization. Generated outputs still require human review for rights, accuracy, and policy compliance.

MIT licensed.