Spaces:
Running
Running
File size: 3,719 Bytes
0fc3485 48ab112 0fc3485 48ab112 0fc3485 48ab112 |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 |
---
title: StyleSync AI
emoji: 🛍️
colorFrom: green
colorTo: indigo
sdk: docker
pinned: false
---
# StyleSync AI
**Turn raw product photos into market-ready listings in seconds.**
---
## 🏗️ Architecture: The Agentic Workflow
StyleSync AI leverages a multi-agent system to automate e-commerce content creation.
* **👁️ Visual Analyst (Gemini 1.5):** Extracts 20+ visual features such as color, style, and material from product images.
* **🧠 Memory Core (Pinecone):** Recalls successful market trends and high-converting SEO keywords using Vector Search (`stylesync-index-v2`).
* **✍️ Copywriter (Llama 3 via Groq):** Synthesizes visual data and market trends into luxury sales copy, focusing on benefits and storytelling.
* **📱 Social Agent:** Generates engaging Instagram captions and relevant hashtags to maximize social reach.
---
## 🚀 Getting Started
### Prerequisites
You will need the following API keys:
* **GEMINI_API_KEY**: For visual analysis and embeddings.
* **GROQ_API_KEY**: For the Llama 3 copywriter.
* **PINECONE_API_KEY**: For vector memory storage.
### Installation
1. Clone the repository:
```bash
git clone https://github.com/yourusername/stylesync-ai.git
cd stylesync-ai
```
2. Install dependencies:
```bash
pip install -r requirements.txt
```
3. Set up your `.env` file with the required API keys.
### Running Locally
Start the FastAPI server:
```bash
uvicorn main:app --reload
```
The API will be available at `http://localhost:8000` (or the port specified in your output).
### Docker
Build and run the container:
```bash
docker build -t stylesync-ai .
docker run -p 7860:7860 --env-file .env stylesync-ai
```
---
## 📚 API Documentation
### Generate Catalog
**Endpoint:** `POST /generate-catalog`
Upload a product image to generate a complete marketing package.
**Request:** `multipart/form-data` with a `file` field.
**Sample Response:**
```json
{
"status": "success",
"visual_analysis": {
"main_color": "Midnight Blue",
"product_type": "Evening Gown",
"design_style": "Elegant",
"visual_features": ["Silk chiffon", "Floor-length", "V-neck"]
},
"market_trends": [
"luxury evening wear",
"formal gala dress",
"summer wedding guest"
],
"final_listing": {
"title": "Midnight Blue Silk Chiffon Evening Gown - Elegant V-Neck Floor-Length Dress",
"description": "Step into the spotlight with this breathtaking Midnight Blue Evening Gown. Crafted from the finest silk chiffon, it drapes effortlessly...",
"features": [
"Luxurious silk chiffon fabric for a soft, flowing silhouette",
"Elegant V-neckline accentuates the décolletage",
"Floor-length design perfect for black-tie events"
],
"price_estimate": "$250 - $400"
}
}
```
---
## ☁️ Deployment
### Hugging Face Spaces
This project is configured for easy deployment to Hugging Face Spaces.
1. Create a new Space (Select **Docker** as the SDK).
2. Upload the code (or connect your GitHub repo).
3. Add your API keys (`GEMINI_API_KEY`, `GROQ_API_KEY`, `PINECONE_API_KEY`) in the Space **Settings > Variables**.
4. The application will automatically build and launch on port `7860`.
---
*StyleSync AI - Autonomous E-Commerce Agent*
|