---
slug: "shopos-prototype"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/tara-shopos/shopos-prototype@main/README.md"
repo: "https://github.com/tara-shopos/shopos-prototype"
source_file: "README.md"
branch: "main"
---
# 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](https://github.com/tara-shopos/shopos-prototype/blob/HEAD/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).