无限文本AI图像生成器

🤖 For AI agents — read, install, and use

Everything to go from zero to results, in order. Zero npm install — the CLI, MCP server, and web server are pure Node. Generation reuses your local ChatGPT/Codex auth (~/.codex/auth.json); log in once (Codex CLI / ChatGPT app) and doctor verifies it.

1. Prerequisites — install only what's missing:

node --version             # need ≥ 22   → else: brew install node   (or https://nodejs.org)
brew install tesseract     # OCR text-check (optional — or run generate with --no-ocr)
brew install cloudflared   # only if you'll expose a public URL (optional)

2. Install & generate:

git clone https://github.com/ezBuilder/omnigen-vault.git && cd omnigen-vault
node bin/omnigen doctor                 # checks auth, disk, OCR, sqlite — fix what it flags
node bin/omnigen generate               # infinite, resumable, text-free (Ctrl-C to stop)

3. Find & reuse an image — one machine-readable command:

node bin/omnigen query "misty mountain at golden hour" --json --limit 5

[{ "path": "~/.omnigen-vault/images/mountains-peaks/landscape/...png",
   "category": "mountains-peaks", "style": "impressionist painting, broken color",
   "size": "1536x1024", "prompt": "…", "tags": ["…"] }]

…or query the live server's JSON API, or call it from Node:

node bin/omnigen serve --port 8787
curl 'localhost:8787/api/search?q=neon%20city&minRating=4&limit=10'

import { resolveConfig, queryVault } from './src/index.js';
const hits = queryVault(resolveConfig(), { query: 'a red fox in snow', limit: 3 });

4. Or wire it straight into your agent over MCP — one command, and your AI searches the vault and gets images back inline (details below):

claude mcp add omnigen --env OMNIGEN_VAULT_ROOT=~/.omnigen-vault -- npx -y -p github:ezBuilder/omnigen-vault omnigen-mcp

🚀 Quick start

git clone <your-repo-url> omnigen-vault && cd omnigen-vault
node bin/omnigen doctor          # checks auth, disk, OCR, thumbnails, sqlite
node bin/omnigen generate        # infinite, resumable generation (Ctrl-C to stop)
node bin/omnigen gallery && open "$(node bin/omnigen stats >/dev/null; echo)"  # build a gallery

Requirements: Node 22+ (uses built-in node:sqlite + fetch — no npm install), a logged-in Codex/ChatGPT session, tesseract for OCR (brew install tesseract), and a mounted external/data disk for the vault.

🌐 Make it public — your own URL (optional)

The gallery is a normal local HTTP server, so any tunnel turns it into a public HTTPS URL — no domain or account of your own required. Start the server, then pick one tunnel:

```bash node bin/omnigen serve --public --port 8787 # read-only, hardened