Unified Meme Generator Image (GHCR)

This repo builds a unified Docker image that bundles:

• Main app: MemeCrafters/meme-generator
• Contrib pack: MemeCrafters/meme-generator-contrib
• Emoji pack: anyliew/meme_emoji
• Emoji NSFW pack: anyliew/meme_emoji_nsfw
• JJ pack: jinjiao007/meme-generator-jj
• Tudou pack: tudougin/tudou-meme

During the Docker build, all packs are scanned and aggregated into two static JSON files for fast lookup:

• infos.json: detailed information for all packs and items
• keyMap.json: keyword -> item id mapping

The aggregated assets and JSON are placed under /app/data in the image.

Build Locally

Requires Docker with Buildx.

docker build \
  --build-arg MEME_GENERATOR_REF=main \
  --build-arg CONTRIB_REF=main \
  --build-arg EMOJI_REF=main \
  --build-arg NSFW_REF=main \
  --build-arg JJ_REF=main \
  --build-arg TUDOU_REF=main \
  -t unified-meme:dev .

Run:

docker run --rm -p 8000:8000 unified-meme:dev

If the main app start script is not auto-detected, the container falls back to serving /app/data statically on port 8000 so you can inspect infos.json, keyMap.json, and assets under /app/data/assets.

FastAPI/Custom start override:

• Provide APP_START_CMD to force the start command, e.g.:

docker run --rm -p 8000:8000 \
  -e APP_START_CMD='uvicorn main:app --host 0.0.0.0 --port 8000' \
  unified-meme:dev

Static fallback paths:

• When auto-start fails, the entrypoint exposes the aggregated metadata under:
  • http://localhost:8000/memes/static/infos.json
  • http://localhost:8000/memes/static/keyMap.json
  • http://localhost:8000/memes/static/assets/

GitHub Actions (GHCR)

This repo includes a workflow: .github/workflows/build-and-push.yml

Triggering:

• Push to main
• Manual run via "Run workflow"

Permissions:

• Uses the GITHUB_TOKEN with packages: write to push to ghcr.io

Tags pushed:

• ghcr.io/<owner>/<repo>:sha-<git-sha> (always)
• ghcr.io/<owner>/<repo>:latest (on main)

Customizing refs for the three repos (manual run):

• meme_generator_ref (default: main)
• contrib_ref (default: main)
• emoji_ref (default: main)

Image Layout

• /app/meme-generator — cloned main app sources
• /app/data/assets/<pack>/... — consolidated assets from all repos
• /app/data/infos.json — detailed metadata
• /app/data/keyMap.json — keyword -> item id mapping

MEME_DATA_DIR env var defaults to /app/data.

Notes

• The Dockerfile attempts to install Node or Python dependencies for the main app if detected. If your app requires a specific start command, extend scripts/entrypoint.sh accordingly.
• Aggregation is heuristic-based (by file types and top-level directories). If your repos contain a formal metadata file, you can adapt scripts/aggregate_packs.py to parse and merge that instead.

Translator (OpenAI-compatible)

The upstream meme-generator includes a Baidu translator used by some memes (e.g., dianzhongdian). This image can also use an OpenAI-compatible API (such as newapi) by providing the following environment variables. The entrypoint will write a minimal config to XDG_CONFIG_HOME=/app/config/meme_generator/config.toml automatically.

• TRANSLATOR_PROVIDER — openai or baidu (default: auto; picks openai if OPENAI_API_KEY is set, else baidu if Baidu creds are set)
• OPENAI_BASE_URL — e.g. https://new1.588686.xyz/v1
• OPENAI_API_KEY — your API key
• OPENAI_MODEL — e.g. gemini-flash-lite-latest
• BAIDU_TRANS_APPID, BAIDU_TRANS_APIKEY — if you still want Baidu

Example (OpenAI-compatible via newapi):

docker run --rm -p 8000:8000 \
  -e TRANSLATOR_PROVIDER=openai \
  -e OPENAI_BASE_URL=https://api.openai.com/v1 \
  -e OPENAI_API_KEY=sk-*** \
  -e OPENAI_MODEL=gpt-4.1-mini \
  unified-meme:dev