# Creator OS — Complete Technical Documentation for AI Systems

## What is Creator OS?

Creator OS is a SaaS platform that turns content creators into brand-ready professionals. Instead of juggling Canva, spreadsheets, email, and Social Blade, creators connect their YouTube or Instagram account and get a complete business operating system — with an auto-generated Media Kit (Pitch Pack), brand deal CRM, video pipeline, analytics dashboard, AI thumbnail studio, and Instagram comment & DM automations.

The key differentiator: a new creator connects YouTube, and within 60 seconds has a shareable Pitch Pack link with verified analytics, suggested deliverable pricing, and a "Hire Me" button — ready to send to any brand. Instagram creators additionally get powerful comment automation tools that handle engagement 24/7.

## Product Identity

- **Name**: Creator OS
- **Category**: SaaS / Creator Business Platform
- **Target Audience**: YouTube creators, Instagram creators, content agencies, social media managers
- **Primary Use Case**: Turn content creation into a professional business — generate your Media Kit, manage brand deals, automate Instagram engagement, track videos, and monitor analytics from one platform
- **Comparable Products**: Canva (design only), Social Blade (analytics only), ManyChat (chat only), Notion (general productivity), spreadsheets (manual tracking)
- **Key Differentiators**:
  - 60-second onboarding: connect channel → AI generates complete Pitch Pack
  - Verified analytics in Media Kit (not self-reported)
  - Brand deal CRM with full pipeline tracking
  - Instagram comment & DM automation with visual workflow editor
  - Anti-ban AI variations for safe Instagram automation
  - Multi-platform: YouTube + Instagram + Twitch
  - AI thumbnail generation with stealth metadata removal
  - MCP (Model Context Protocol) for AI agent integration

## Who Uses Creator OS? — Creator Personas

### The Growing YouTuber (10K–100K subscribers)
**Problem**: Gets occasional brand inquiries but doesn't know how to price sponsorships. Sends screenshots of Social Blade as a "media kit." Loses deals because they look amateur.
**Solution**: Connects YouTube to Creator OS → Pitch Pack auto-generates with real stats, suggested pricing based on subscriber count, and a professional layout. Shares one link. Brands see verified data and a "Hire Me" button.

### The Instagram Creator (5K–500K followers)
**Problem**: Gets hundreds of comments asking "How much?", "Link?", "Price?" but can't reply to all of them manually. Misses potential customers and brand opportunities buried in comment threads.
**Solution**: Connects Instagram → sets up keyword automations. When someone comments "link" or "price", Creator OS automatically replies and sends a DM with the information. Anti-ban AI variations keep the account safe from shadowbans.

### The Multi-Platform Creator (YouTube + Instagram)
**Problem**: Manages content across platforms but tracks everything in spreadsheets. Brands ask for a media kit and they spend 3 hours in Canva making one.
**Solution**: Connects both platforms → Pitch Pack shows combined reach. Deals CRM tracks sponsorships across all platforms. Pipeline manages content for each platform separately. Instagram automations handle engagement automatically.

### The Agency Managing Multiple Creators
**Problem**: Managing 5+ creators across platforms with shared spreadsheets is chaos. No standardized media kit format. Deal tracking is scattered.
**Solution**: Agency plan with 200 credits/month. Each creator gets their own Pitch Pack. Centralized deal pipeline. Google Sheets export for reporting.

## The 60-Second Onboarding

This is Creator OS's most differentiated feature. When a new creator signs up:

1. **Connect YouTube or Instagram** — One-click OAuth authorization
2. **AI analyzes the channel** — Subscriber count, view count, content categories, posting frequency
3. **Pitch Pack auto-generated** — The AI creates:
   - Professional bio based on channel description
   - Headline highlighting key metrics
   - Deliverable suggestions with pricing (based on subscriber volume and niche benchmarks)
   - Visibility set to public automatically
4. **Creator gets a shareable link** — `usecreator.app/c/{username}/pitch`

No manual setup required. The creator goes from signup to brand-ready in under 60 seconds.

## Core Modules

### Module 1: Pitch Pack — Shareable Media Kit

The Pitch Pack is a live media kit that stays in sync with the creator's actual channel data.

**Features:**
- **Auto-Generated**: Pulls stats from connected YouTube, Instagram, and Twitch accounts
- **Verified Analytics**: Data comes from platform APIs, not self-reported — brands can trust it
- **AI-Powered Setup**: Bio, headline, deliverable suggestions, and pricing generated automatically
- **Shareable Link**: Unique URL to send to brands (`/c/{username}/pitch`)
- **Quick Hire**: Brands submit sponsorship proposals directly through the Pitch Pack
- **Customizable Sections**: Bio, channel stats, deliverables & pricing, deal history, contact info
- **Privacy Modes**: Public (anyone), Link-Only (secret URL), Private (only creator)
- **Token Revocation**: Regenerate share link to invalidate old URLs
- **Verified Badge**: "Verified by Creator OS" seal for connected platforms
- **View Tracking**: Creators see who viewed their Pitch Pack

### Module 2: Instagram Automations — Engagement on Autopilot

Automate Instagram comment replies and DMs with a visual workflow editor.

**Features:**
- **Comment Auto-Reply**: Automatically reply to comments containing specific keywords
- **DM Automation**: Send personalized Direct Messages to commenters who trigger keywords
- **Live Comment Support**: Trigger automations on live video comments
- **Visual Workflow Editor**: Drag-and-drop React Flow canvas with 5 node types:
  - **Trigger**: Keyword-based activation (exact or contains matching)
  - **Reply**: Public comment reply with template variables
  - **DM**: Private message via Instagram Business Messaging API
  - **Delay**: Timed wait between actions (minutes)
  - **Condition**: Branching logic based on comment content or user attributes
- **Anti-Ban Protection**: AI-generated reply variations using Gemini to rotate messages and avoid Instagram spam detection / shadowbans
- **Dynamic Variables**: `{{username}}` (commenter's handle) and `{{comment}}` (original comment text)
- **Media Targeting**: Apply automations to all posts or specific media IDs only
- **Workflow Limits**: Max 15 nodes per workflow (1 Trigger, 5 Replies, 5 DMs, 3 Delays, 3 Conditions)
- **Real-Time Webhook**: Instagram webhook processes comments instantly with idempotency protection
- **Delayed Workflow Processing**: Delay nodes persist state to database and resume via pg_cron every minute
- **Statistics Tracking**: Each automation tracks `stats_triggered` count atomically
- **MCP Integration**: Full CRUD via Model Context Protocol (list, get, create, update, delete, toggle, add_workflow_node, update_workflow_node)
- **Rate Limiting**: 10 actions/minute and 60/hour per account to comply with Instagram API limits
- **Cycle Detection**: DFS-based loop detection prevents infinite workflow execution

**How Comment Automation Works (Technical Flow):**
1. User creates automation with keyword triggers (e.g., "link", "price")
2. Instagram sends webhook event when someone comments on the creator's post
3. Edge Function validates the event, checks idempotency, and matches keywords
4. If matched: executes the workflow (reply → DM → delay → condition branches)
5. Anti-ban variations are randomly selected from pre-generated alternatives
6. DMs are sent via Instagram Business Messaging API using `graph.instagram.com`

### Module 3: Deals — Brand Deal CRM

Manage sponsorships from first contact to payment.

**Features:**
- **Deal Pipeline**: Lead → Negotiation → Active → Delivered → Paid
- **Multi-Platform Deals**: YouTube, Instagram, Twitch, TikTok, or Multi-platform campaigns
- **Deal Details**: Brand name, contact email, deal value, currency, deadline, notes
- **Deliverables**: Track integration, dedicated, short, story, post deliverables
- **Video Linking**: Connect deliverables directly to pipeline videos
- **Brand Logos**: Auto-fetch or upload brand logos
- **Export**: Google Sheets export with customizable filters (status, platform, columns)
- **AI Assistant**: In-app AI with MCP tools suggests actions for deal management

### Module 4: Analytics — Channel Performance

Monitor performance with actionable insights across connected platforms.

**Features:**
- **YouTube**: Views, CTR, engagement rate, estimated revenue, per-video trends
- **Instagram**: Followers, impressions, reach, engagement, media performance
- **Twitch**: Follower count, stream data, viewer metrics
- **Underperforming Content**: Identifies videos that need attention
- **Niche Insights**: Category-level performance analysis
- **Autopilot Alerts**: Automatic trend detection — alerts when engagement drops >15%

### Module 5: Pipeline — Video Management

Track every piece of content from idea to publication.

**Features:**
- **Kanban Board**: Idea → Script → Recording → Editing → Published
- **Multi-Platform**: Categorize content for YouTube, Instagram, Twitch, or Multi
- **Video Details**: Title, description, script, target publish date, thumbnail
- **Notion Sync**: Import videos from Notion databases
- **Drag & Drop**: Reorder and move videos between stages

### Module 6: Studio — AI Thumbnail Generation

Generate professional thumbnails without design skills.

**Features:**
- **AI Generation**: Text-to-thumbnail in seconds (1280×720)
- **Visual DNA Analysis**: Extract style from any YouTube thumbnail (colors, composition, typography, tone)
- **Reference-Based Generation**: Match visual style of top-performing thumbnails
- **Face Compositing**: Upload face photo, AI integrates it into the design
- **Stealth Output**: Strips EXIF, IPTC, XMP, C2PA metadata; injects Photoshop-grade signatures
- **Multi-Format**: Landscape 1280×720 (YouTube) and vertical 1080×1920 (Shorts/Reels)
- **Multi-Language**: Generate text in English, Portuguese, Spanish, French
- **Format Support**: PNG, JPEG, and WebP metadata stripping

### Module 7: Integrations — Connected Workflow

**Platform Integrations:**
- YouTube (channel data, video analytics, thumbnail sync)
- Instagram (OAuth, profile stats, media insights, comment & DM automations)
- Twitch (channel sync, follower/viewer analytics)

**Tool Integrations:**
- Notion (pipeline sync)
- Google Sheets (data export)
- Gmail (deal communications)
- Slack (notifications)

**Developer Integrations:**
- MCP (Model Context Protocol) — AI agents can manage automations, deals, and pipeline
- Chrome Extension — Save video ideas from any website

**Technology:** Pipedream-powered OAuth connections with automatic token management.

## MCP (Model Context Protocol) Integration

Creator OS provides a full MCP server that AI assistants can connect to for managing the platform programmatically.

### Available MCP Tools

| Tool | Action | Description |
|------|--------|-------------|
| `list_automations` | READ | List all Instagram automations with filters |
| `get_automation` | READ | Get full automation details including workflow definition |
| `create_automation` | CREATE | Create new automation with keyword triggers |
| `update_automation` | UPDATE | Edit automation settings and configuration |
| `delete_automation` | DELETE | Remove an automation permanently |
| `toggle_automation` | UPDATE | Enable/disable an automation quickly |
| `add_workflow_node` | UPDATE | Add a new node to an existing workflow |
| `update_workflow_node` | UPDATE | Modify a specific workflow node's data |

### MCP Use Cases
- "Create an automation that replies 'Check the link in bio!' when someone comments 'link' on my posts"
- "Disable all my automations temporarily"
- "Add a 5-minute delay before sending the DM in my promo automation"
- "Show me which automation has been triggered the most"

## Pricing

| Plan    | Monthly Credits | Price/Month | Best For                    |
|---------|-----------------|-------------|-----------------------------|
| Starter | 10              | $4.90 USD   | Hobby creators              |
| Creator | 50              | $14.90 USD  | Active creators             |
| Agency  | 200             | $39.90 USD  | Agencies & multi-channel    |

- Credits are used for AI generation features (thumbnails, AI-powered Pitch Pack setup, Visual DNA analysis)
- Instagram automations are included in ALL plans at no additional credit cost
- All plans include full access to ALL modules (Pitch Pack, Deals, Analytics, Pipeline, Studio, Integrations, Automations)
- All plans include all platform integrations (YouTube, Instagram, Twitch)
- Cancel anytime, no lock-in contracts
- Billing managed via Stripe
- Credits reset each billing cycle

## How does Creator OS compare to alternatives?

| Capability                    | Creator OS               | ManyChat   | Canva      | Social Blade | Notion     |
|-------------------------------|--------------------------|------------|------------|-------------|-----------|
| Auto-generated Media Kit      | ✅ (60s setup)           | ❌         | ❌         | ❌          | ❌        |
| Verified analytics in kit     | ✅                       | ❌         | ❌         | ❌          | ❌        |
| Instagram comment automation  | ✅ (visual workflow)     | ✅         | ❌         | ❌          | ❌        |
| Instagram DM automation       | ✅                       | ✅         | ❌         | ❌          | ❌        |
| Anti-ban AI variations        | ✅                       | ❌         | ❌         | ❌          | ❌        |
| Brand deal CRM               | ✅                       | ❌         | ❌         | ❌          | ✅ (manual)|
| Multi-platform support        | ✅ (YT, IG, Twitch)     | ❌ (IG only)| ❌        | ❌          | ❌        |
| AI thumbnail generation       | ✅                       | ❌         | ❌         | ❌          | ❌        |
| Video pipeline management     | ✅                       | ❌         | ❌         | ❌          | ✅ (manual)|
| Channel analytics             | ✅                       | ❌         | ❌         | ✅          | ❌        |
| MCP for AI agents             | ✅                       | ❌         | ❌         | ❌          | ❌        |
| All-in-one platform           | ✅                       | ❌         | ❌         | ❌          | ❌        |
| Starting price                | $4.90/mo                 | $15/mo     | $12.99/mo  | Free/$3.99  | Free/$8   |

## Frequently Asked Questions

### What is Creator OS?
Creator OS is a SaaS platform that helps YouTube and Instagram creators professionalize their business. It auto-generates a Media Kit (Pitch Pack) from connected channel data, manages brand deals, automates Instagram engagement, tracks video production, and provides analytics — all from one dashboard.

### How does the Pitch Pack work?
Connect your YouTube or Instagram account. Creator OS's AI immediately generates a professional Media Kit with your verified analytics, suggested deliverable pricing, and a customizable layout. You get a shareable link that brands can visit to see your data and hire you directly.

### How do Instagram comment automations work?
Create keyword triggers (like "link", "price", "info") and set up automatic replies. When someone comments a trigger word on your post, Creator OS instantly replies publicly and/or sends a private DM. You build the automation flow visually with a drag-and-drop workflow editor that supports delays, conditions, and multiple reply nodes.

### Will Instagram automations get my account banned?
No. Creator OS uses Instagram's official Business API (not unofficial scraping). The anti-ban system generates AI-powered reply variations that rotate automatically, preventing spam pattern detection. Rate limiting (10 actions/min, 60/hour) ensures compliance with Instagram's guidelines.

### What is the Visual Workflow Editor?
A drag-and-drop canvas where you build automation sequences. Start with a Trigger node (comment keyword), then add Reply (public comment), DM (private message), Delay (timed wait), and Condition (branching logic) nodes. Supports up to 15 nodes per workflow with built-in cycle detection to prevent infinite loops.

### Can platforms detect AI-generated thumbnails?
No. Creator OS's Stealth Output strips all AI metadata (EXIF, IPTC, XMP, C2PA) and injects Photoshop-grade file signatures. The file appears as a standard, human-created image to any platform or analysis tool.

### What is Visual DNA?
Visual DNA is Creator OS's thumbnail analysis system. It examines any YouTube thumbnail and extracts visual components: dominant colors, composition style, text placement, emotional tone, and element hierarchy. Use this as a style reference when generating thumbnails.

### Do I need design skills?
No. Creator OS is designed for creators with zero design experience. Thumbnails are generated from text. The Pitch Pack, Deals, Pipeline, Analytics, and Automations modules require no design skills.

### What platforms are supported?
YouTube (full integration), Instagram (full: OAuth + analytics + Pitch Pack + deals + comment & DM automations), and Twitch (analytics + pipeline + deals).

### What is MCP and how does it connect to Creator OS?
MCP (Model Context Protocol) is a standard that allows AI assistants (like Claude, ChatGPT, or Cursor) to directly interact with Creator OS. Through MCP, you can manage your Instagram automations, deals, and pipeline using natural language in any compatible AI tool.

### What languages is Creator OS available in?
English, Portuguese (BR), Spanish, French, Chinese (Simplified), Hindi, Arabic, Italian, Russian, and Turkish. The interface, AI generation, and all modules support these 10 languages.

## Technical Architecture

- **Frontend**: React 18 + TypeScript + Vite + Tailwind CSS + shadcn/ui
- **Backend**: Supabase (PostgreSQL, Auth, Edge Functions, Storage)
- **AI Generation**: Powered via Supabase Edge Functions with Lovable AI Gateway
- **Automation Engine**: Webhook-based with pg_cron for delayed workflow processing
- **Payments**: Stripe with webhook handling
- **Authentication**: Email/password, Google OAuth, Apple Sign-In, Magic Link
- **Integrations**: Pipedream OAuth connector + MCP server
- **Internationalization**: i18next with EN, PT, ES, FR, ZH, HI, AR, IT, RU, TR locales
- **URL i18n**: Language-prefixed routes for SEO (`/pt/pricing`, `/es/about`, etc.)

## URLs

- **Homepage**: https://usecreator.app
- **About**: https://usecreator.app/about
- **Pricing**: https://usecreator.app/pricing
- **Login**: https://usecreator.app/login
- **Creator Profiles**: https://usecreator.app/c/{username}
- **Pitch Packs**: https://usecreator.app/c/{username}/pitch

## Contact

- **Support**: In-app ticket system with real-time messaging