https://github.com/vero-code/ethno-lens-ai

Adobe Express Add-on that analyzes cultural sensitivity of design elements using AI.
https://github.com/vero-code/ethno-lens-ai

add-on adobe adobe-express ai cultural-analytics design gemini generative-ai

Last synced: 3 months ago
JSON representation

Adobe Express Add-on that analyzes cultural sensitivity of design elements using AI.

• Host: GitHub
• URL: https://github.com/vero-code/ethno-lens-ai
• Owner: vero-code
• License: mit
• Created: 2025-07-06T16:34:59.000Z (3 months ago)
• Default Branch: master
• Last Pushed: 2025-07-13T11:33:33.000Z (3 months ago)
• Last Synced: 2025-07-13T13:21:51.296Z (3 months ago)
• Topics: add-on, adobe, adobe-express, ai, cultural-analytics, design, gemini, generative-ai
• Language: JavaScript
• Homepage: https://devpost.com/software/ethnolens-ai
• Size: 229 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# EthnoLens AI

[![Adobe Express](https://img.shields.io/badge/platform-Adobe%20Express-purple.svg)](https://express.adobe.com/)

[![JavaScript](https://img.shields.io/badge/language-JavaScript-F7DF1E.svg?logo=javascript&logoColor=black)](https://developer.mozilla.org/en-US/docs/Web/JavaScript)

[![Gemini](https://img.shields.io/badge/AI-Gemini-blueviolet.svg?logo=google)](https://deepmind.google/technologies/gemini/)

An AI-powered design add-on that scans your visuals and flags potential cultural, ethical, or symbolic pitfalls — before they become costly mistakes.

Built for global creators. Powered by Gemini. Designed for Adobe Express.

👉 This project was created for the ["Adobe Express Add-ons Hackathon"](https://devpost.com/software/ethnolens-ai).

 

## 🧠 Core AI Capabilities

- 🧠 **Cultural check with AI** — Get instant feedback on how design fits different cultures.

- 🌍 **Country-aware analysis** — Adjusts results based on your chosen region.

- 🏢 **Business type context** — Improves accuracy using industry-specific context.

- 💬 **Follow-up chat with AI** — Ask clarification questions right after the analysis.

- 🖼️ **Image analysis** — Upload images for cultural and ethical review.

### 🛠️ Design Analysis Tools

- 🔍 **Smart element scanning** — Detects text, colors, and shapes.

- 🔌 **Seamless Adobe Express integration** — Works right inside your design workflow.

- ⚙️ **Easy to extend** — Built for future element types and features.

### 📐 Output & UI Features

- 🧾 **Clean markdown output** — Neatly formatted AI replies.

- ⏳ **Built-in loading indicator** — Shows AI activity status.

- 🛡️ **Helpful error messages** — Alerts if something’s missing or wrong.

## Tools

This project has been created with _@adobe/create-ccweb-add-on_ and is designed to run inside **Adobe Express**.

- HTML, CSS

- JavaScript, Node.js

- Adobe Express Add-on API

- Gemini 2.5 Flash

## Setup

To run this add-on locally:

1. **Fork this repository** and clone it to your machine.

2. Navigate into the project folder.

3. Install dependencies: `npm install`.

4. Build the application: `npm run build`.

5. Start the development server: `npm run start`.

> ⚠️ To run the add-on inside Adobe Express, you’ll need an [Adobe Developer account](https://developer.adobe.com/) and follow the local setup instructions in the official docs: [Development Tools](https://developer.adobe.com/express/add-ons/docs/guides/getting_started/local_development/dev_tooling/).

## 📜 License

This project is open-source under the MIT License — meaning you’re free to use, change, and share it, even in commercial projects. Just keep the original [LICENSE](LICENSE) info.

Want to help out?

Feel free to report bugs, suggest features, or open a pull request!