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)

Setup

# 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.

🛠️ 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).