Skip to content

Commit a2164bb

Browse files
authored
Merge pull request #2720 from oracle-devrel/removing-duplicate
Added new image generation asset
2 parents c601072 + 86064a3 commit a2164bb

7 files changed

Lines changed: 531 additions & 0 deletions

File tree

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
Copyright (c) 2025 Oracle and/or its affiliates.
2+
3+
The Universal Permissive License (UPL), Version 1.0
4+
5+
Subject to the condition set forth below, permission is hereby granted to any
6+
person obtaining a copy of this software, associated documentation and/or data
7+
(collectively the "Software"), free of charge and under any and all copyright
8+
rights in the Software, and any and all patent rights owned or freely
9+
licensable by each licensor hereunder covering either (i) the unmodified
10+
Software as contributed to or provided by such licensor, or (ii) the Larger
11+
Works (as defined below), to deal in both
12+
13+
(a) the Software, and
14+
(b) any piece of software and/or hardware listed in the lrgrwrks.txt file if
15+
one is included with the Software (each a "Larger Work" to which the Software
16+
is contributed by such licensors),
17+
18+
without restriction, including without limitation the rights to copy, create
19+
derivative works of, display, perform, and distribute the Software and make,
20+
use, sell, offer for sale, import, export, have made, and have sold the
21+
Software and the Larger Work(s), and to sublicense the foregoing rights on
22+
either these or other terms.
23+
24+
This license is subject to the following condition:
25+
The above copyright notice and either this complete permission notice or at
26+
a minimum a reference to the UPL must be included in all copies or
27+
substantial portions of the Software.
28+
29+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
30+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
31+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
32+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
33+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
34+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
35+
SOFTWARE.
Lines changed: 84 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,84 @@
1+
# SKU Image Studio — OCI GenAI
2+
3+
*A Streamlit-based application that generates lifestyle and product imagery for retail SKUs using Oracle Generative AI. The asset automates the creation of market-localised, shot-type-specific product visuals from structured product inputs, eliminating manual photography briefing and reducing time-to-asset for high-volume SKU catalogues.*
4+
5+
Author: Ali Ottoman
6+
7+
Reviewed date: 27.03.2026
8+
---
9+
10+
![Demo](sku_image_generation_studio.gif)
11+
12+
---
13+
14+
# When to use this asset?
15+
16+
*This asset is used by retail, e-commerce, and digital transformation teams when high-volume, market-localised product imagery is required without manual photography overhead.*
17+
18+
### Who
19+
- E-commerce teams managing large SKU catalogues requiring frequent visual refresh
20+
- Retail marketing teams producing localised imagery across multiple target markets
21+
- Digital transformation teams modernising manual product photography workflows
22+
23+
### When
24+
- SKU volume makes per-product photography cost-prohibitive
25+
- Market-specific visual variants are required (regional demographics, settings, tone)
26+
- Rapid concept visualisation is needed before committing to a full production shoot
27+
- Consistent, brand-aligned output is required at scale
28+
29+
# How to use this asset?
30+
31+
*The asset is deployed as a Streamlit application and guides users through entering product details, selecting visual parameters, and generating imagery.*
32+
33+
### Application Workflow
34+
1. Enter product details:
35+
- Product name
36+
- Description (positioning, materials, key attributes)
37+
2. Select visual parameters:
38+
- Target market
39+
- Shot type
40+
- Setting / context
41+
3. Click **Generate Image**
42+
4. Review:
43+
- Generated product image
44+
- Metadata summary (market, shot type, setting, resolution)
45+
- Prompt sent to the model (for auditability and iteration)
46+
- Downloadable PNG output
47+
48+
### Key Capabilities
49+
- Structured prompt construction from discrete UI inputs — no prompt engineering required from the operator
50+
- Market localisation across five regional profiles (Middle East, Western Europe, North America, South & Southeast Asia, Global)
51+
- Shot type control: Editorial, Candid, Flat Lay, On-Model, Product Only
52+
- Setting control: Studio, Home, Urban, Café, Nature
53+
- Full prompt transparency — the model prompt is surfaced in the UI for review and iteration
54+
- One-click PNG download per generated asset
55+
56+
### File Structure
57+
```
58+
.
59+
├── app.py
60+
├── prompt_builder.py
61+
├── oci_client.py
62+
├── requirements.txt
63+
└── README.md
64+
```
65+
66+
### Setup
67+
```bash
68+
pip install -r requirements.txt
69+
streamlit run app.py
70+
```
71+
72+
Update `oci_client.py` with your `COMPARTMENT_ID` and `PROFILE_NAME`.
73+
74+
# Useful Links
75+
76+
- OCI Generative AI Documentation
77+
- https://docs.oracle.com/en-us/iaas/Content/generative-ai/home.htm
78+
79+
# License
80+
81+
Copyright (c) 2026 Oracle and/or its affiliates.
82+
Licensed under the Universal Permissive License (UPL), Version 1.0.
83+
84+
See [LICENSE](https://github.com/oracle-devrel/technology-engineering/blob/main/LICENSE.txt) for more details.

0 commit comments

Comments
 (0)