# ShopOS 🌌

**AI-powered e-commerce operating system for brand marketers.**

ShopOS is a sophisticated platform designed to streamline brand marketing and catalog generation through advanced AI agents and specialized skills. It leverages the Gemini 2.0 models to provide a premium, real-time creative experience.

## ✨ Key Features

- **Multi-modal Agent**: Seamlessly generate images, videos, and marketing copy.
- **Intelligent Image Editing**: Context-aware editing that preserves your backgrounds and scene atmosphere.
- **Skills System**: Extensible architecture for specialized tasks like fashion photography, brand-consistent visuals, and virtual try-ons.
- **Real-time Collaboration**: Instant UI updates and state synchronization via WebSockets.
- **Premium Design**: A canvas-like aesthetic with dark mode support and a focus on visual excellence.

## 🚀 Quick Start

### Prerequisites
- Node.js >= 20.0.0
- pnpm >= 9.15.0
- Docker Desktop
- **Gemini API Key** (get from [Google AI Studio](https://aistudio.google.com/app/apikey))

### Setup

```bash
# 1. Install dependencies
pnpm install

# 2. Set up environment variables
cp .env.example .env                      # Frontend config
cp apps/api/.env.example apps/api/.env    # Backend config (add your API keys here!)

# 3. Start infrastructure
pnpm docker:up

# 4. Initialize database
pnpm db:generate && pnpm db:push && pnpm db:seed

# 5. Start development
pnpm dev
```

For detailed setup instructions, see our **[Setup & Development Guide](CONTRIBUTING.md)**.

## 🛠️ Stack

- **Frontend**: Next.js, Radix UI, TailwindCSS, Lucide Icons, Zustand.
- **Backend**: NestJS, Prisma (Postgres), Redis, Socket.io, Qdrant.
- **AI**: Gemini 2.0 Flash (Text & Image), Imagen 3.0 (Image), Veo (Video).