KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #codex #typescript #developer-tools #ai-agents #deepseek-harness #claude-code #ai-agent #cli #react #mcp

image2-ads-studio

★ 45 Open GitHub ↗

Advertising prompt agent for Image2: turns business briefs and reference images into debranded, production-ready image prompts.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Image2 Ads Studio

[中文文档](README.zh-CN.md) | [English gallery](examples/gallery/cases.md) | [中文案例库](examples/gallery/cases.zh-CN.md)

Advertising prompt agent for Image2: turn business briefs and reference images into debranded, production-ready image prompts.

中文定位：面向 Image2 广告作图的开源 Prompt Agent，把客户白话需求、文案、行业和参考图转成可测试、可追踪、可集成的优化提示词。

This is not another prompt dump. Prompt libraries are useful for browsing examples; Image2 Ads Studio is a working prompt pipeline for advertising production. It parses a customer brief, retrieves advertising templates and visual recipes, rewrites references through an LLM prompt brain, validates deterministic execution details, and returns an optimized prompt that can be manually tested in Image2.

This repository is the **Community Edition**. It opens the agent framework, local Web workbench, all current 320 business templates, 240 visual recipes, LLM prompt brain interface, deterministic prompt checks, reference image policy, and a public case gallery.

![Workflow](https://raw.githubusercontent.com/kwistzzqq-byte/image2-ads-studio/main/docs/assets/github-workflow.svg)

## Why This Is Different

Most Image2 prompt repositories answer: "What prompt can I copy?"

Image2 Ads Studio answers: "Given this business brief, copywriting, industry, aspect ratio, and reference image, what prompt should the agent produce?"

| Prompt libraries | Image2 Ads Studio |
| --- | --- |
| Curated examples for inspiration | Runnable advertising prompt agent |
| Start from existing prompts | Start from customer brief and reference images |
| General creative coverage | Advertising vertical: storefronts, posters, ecommerce, product ads, signage, brand walls, commercial photography |
| Prompt text is the product | Parser, retriever, compiler, LLM rewrite, deterministic checks, and JSON records are the product |
| Usually copy/paste driven | Produces parsed intent, matched templates, visual recipes, design plan, optimized prompt, and source policy |
| References may stay close to source | Public gallery prompts are regenerated, debranded, attributed, and made reusable |
| Hard to connect to business systems | Designed for later ERP fields, template governance, adapters, and production workflows |

## Prompt Gallery

The public gallery contains 100 image-to-prompt cases from project-generated concepts and multiple in-repo source libraries. Each case includes one preview image, English and Chinese optimized prompts, source attribution, and an in-repo composite source made from matched advertising templates plus visual recipes.

View the full gallery: [English cases](examples/gallery/cases.md) / [中文案例](examples/gallery/cases.zh-CN.md)

| Preview | Optimized Prompt Excerpt |
| --- | --- |
| <img src="docs/assets/gallery/cases/owner-beverage-ad-concept.jpg" alt="Beverage product ad concept" width="260"> | **Beverage Product Ad Concept** `Create a commercially usable 16:9 beverage advertising hero image for a new debranded sparkling drink. Composition: place a tall matte-gloss red can slightly right of center...` |
| <img src="docs/assets/gallery/cases/owner-product-ad-concept.jpg" alt="Premium appliance product ad concept" width="260"> | **Premium Appliance Product Ad Concept** `Create a 16:9 premium consumer-electronics product advertising hero image for a debranded high-end airflow appliance. Use a black-and-champagne-gold cylindrical device...` |
| <img src="docs/assets/gallery/cases/gallery-03-e-commerce-main-image-luxury-amber-perfume-ad.jpg" alt="Luxury amber perfume ad prompt case" width="260"> | **Luxury Amber Perfume Ad** `Create a square 1:1 luxury beauty product advertisement for a debranded amber perfume bottle. Show one classic rectangular glass bottle as the hero object...` |
| <img src="docs/assets/gallery/cases/gallery-05-e-commerce-main-image-tropical-citrus-soda-ad-poster.jpg" alt="Tropical citrus soda ad prompt case" width="260"> | **Tropical Citrus Soda Ad Poster** `Create a 9:16 vertical commercial beverage poster for a tropical citrus soda campaign. Show one large transparent plastic bottle as the hero object...` |
| <img src="docs/assets/gallery/cases/gallery-32-moss-radio-brand-identity-showcase-board.jpg" alt="Brand identity showcase prompt case" width="260"> | **Moss Radio Brand Identity Showcase Board** `Create a square 1:1 brand-identity showcase board for a fictional audio, retail, or culture-focused business. Build a dense editorial presentation...` |
| <img src="docs/assets/gallery/cases/gallery-36-zoo-visitor-wayfinding-map.jpg" alt="Wayfinding map prompt case" width="260"> | **Zoo Visitor Wayfinding Map** `Create a polished 16:9 advertising-style wayfinding map board for a fictional wildlife park campaign, designed as a commercially usable tourism graphic...` |
| <img src="docs/assets/gallery/cases/gallery-47-e-commerce-product-detail-page-layout.jpg" alt="Ecommerce product detail prompt case" width="260"> | **E-Commerce Product Detail Page Layout** `Create a 9:16 vertical e-commerce product detail poster for a futuristic consumer electronics hero product. Use a dense marketplace layout...` |

Source and license notes are tracked in [gallery attribution](examples/gallery/ATTRIBUTION.md). The gallery is not a copied prompt collection: upstream prompts/images are used as structure references, then this project regenerates, debrands, and normalizes the final prompt through the same agent flow used by the Web workbench.

## Why It Exists

General image-generation prompts are unstable for advertising production. A local shop owner may say "make a milk tea storefront signboard", but production-ready output needs structure: task type, industry, copywriting, aspect ratio, material constraints, reference image policy, and clear composition.

Image2 Ads Studio turns that loose brief into a structured advertising plan and an optimized prompt that can be manually tested in Image2 or another image-generation tool.

## Core Features

- Advertising vertical coverage: storefront signboards, posters, roll-up banners, event backdrops, wayfinding signage, brand walls, local promotions, ecommerce main images, product ads, and commercial photography.
- Open template library: 320 business templates and 240 visual recipes.
- LLM prompt brain: uses a Responses-compatible LLM endpoint to refine the rule prompt.
- Reference image policy: user uploads can be read by the LLM and marked for later Image2 editing; upstream references are only used for visual understanding.
- Deterministic prompt validation: removes vague expressions and requires composition, lighting, typography, material, and image-reference policy.
- Local Web UI: prompt workbench with brief input, optimized prompt output, preview placeholder, and retrieval signals.

## Quick Start

```bash
pnpm install
pnpm --filter ad-image-agent-core test
pnpm --filter ad-image-agent build
export OPENAI_API_KEY="your_api_key"
pnpm --filter ad-image-agent serve:llm
```

Open:

```text
http://127.0.0.1:5174
```

The app does not call an image-generation API in this edition. Copy the optimized prompt into your image-generation tool and upload user reference images when the app marks them for Image2 participation.

## Architecture

```mermaid
flowchart LR
  A[User Brief] --> B[Intent Parser]
  B --> C[Template Retriever]
  C --> D[Visual Recipe Retriever]
  D --> E[LLM Prompt Brain]
  E --> F[Optimized Prompt]
  F --> G[Image2 Manual Test]
  G --> H[Case Library]
  H -. Template / Recipe Update .-> C
  H -. Template / Recipe Update .-> D
```

## Community vs Commercial

| Capability | Community Edition | Commercial Edition |
| --- | --- | --- |
| Local Web UI | Included | Included |
| Core prompt agent framework | Included | Included |
| Business templates | 320 open templates | Custom/private templates and governance |
| Visual recipes | 240 open recipes | Custom/private recipes and scored evaluation |
| LLM prompt brain | Interface + local server | Production setup |
| Image generation | Manual adapter | Real adapters and storage |
| ERP integration | Overview docs | Connectors, field mapping, deployment |
| Case gallery | Public samples | Private scored case library |

Commercial work can add ERP connectors, real image-generation adapters, deployment support, custom private templates, and production case evaluation.

## Repository Layout

```text
apps/ad-image-agent              Local Web workbench
packages/ad-image-agent-core     Parser, retrievers, compiler, adapters, tests
examples                         Sample briefs and generated records
docs                             Architecture, adapter, ERP, authoring, roadmap
scripts                          Community validation and asset counting
```

## Development

```bash
pnpm --filter ad-image-agent-core test
pnpm --filter ad-image-agent-core build
pnpm --filter ad-image-agent typecheck
pnpm --filter ad-image-agent build
```

## License

Apache-2.0. See [LICENSE](LICENSE).

image2-ads-studio

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README