> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/darkzOGx/youtube-automation-agent/llms.txt
> Use this file to discover all available pages before exploring further.

# YouTube Automation Agent

> Fully automated YouTube channel management with AI agents that creates, optimizes, and publishes videos 24/7

<div
  style={{
background: 'linear-gradient(135deg, #020627 0%, #11161e 100%)',
padding: '60px 40px',
borderRadius: '12px',
marginBottom: '40px',
border: '1px solid rgba(96,99,146,0.3)'
}}
>
  <h1
    style={{
fontSize: '48px',
fontWeight: '700',
marginBottom: '20px',
background: 'linear-gradient(135deg, #ffffff 0%, #cfd0d2 100%)',
WebkitBackgroundClip: 'text',
WebkitTextFillColor: 'transparent',
backgroundClip: 'text'
}}
  >
    Automate Your YouTube Success
  </h1>

  <p
    style={{
fontSize: '20px',
color: '#cfd0d2',
marginBottom: '30px',
maxWidth: '800px'
}}
  >
    Complete AI-powered system with 7 specialized agents that research trends, write scripts, design thumbnails, optimize SEO, and publish videos automatically.
  </p>

  <div style={{ display: 'flex', gap: '16px', flexWrap: 'wrap' }}>
    <a
      href="/quickstart"
      style={{
  background: '#238636',
  color: '#ffffff',
  padding: '12px 24px',
  borderRadius: '6px',
  textDecoration: 'none',
  fontWeight: '600',
  display: 'inline-block'
}}
    >
      Get Started
    </a>

    <a
      href="https://github.com/darkzOGx/youtube-automation-agent"
      style={{
  background: 'transparent',
  color: '#ffffff',
  padding: '12px 24px',
  borderRadius: '6px',
  border: '1px solid rgba(255,255,255,0.2)',
  textDecoration: 'none',
  fontWeight: '600',
  display: 'inline-block'
}}
    >
      View on GitHub
    </a>
  </div>
</div>

## Why YouTube Automation Agent?

<CardGroup cols={2}>
  <Card title="100% Automated" icon="robot">
    AI agents handle everything from content strategy to publishing, running 24/7 without manual intervention
  </Card>

  <Card title="Free Tier Available" icon="dollar-sign">
    Works with Google Gemini's free tier - create multiple videos daily at no cost
  </Card>

  <Card title="7 Specialized Agents" icon="users">
    Content strategy, script writing, thumbnail design, SEO, production, publishing, and analytics
  </Card>

  <Card title="No Coding Required" icon="magic">
    Simple setup wizard and web dashboard - just configure and let it run
  </Card>
</CardGroup>

## Key Features

<AccordionGroup>
  <Accordion title="Content Strategy Agent" icon="lightbulb">
    Analyzes YouTube trends via API, identifies viral topics in your niche, and plans content calendar automatically based on real-time data and competitor research.
  </Accordion>

  <Accordion title="Script Writer Agent" icon="pen">
    Generates engaging scripts with hooks, storytelling, and call-to-actions using multiple templates (tutorial, explainer, list, review, story) optimized for watch time.
  </Accordion>

  <Accordion title="Thumbnail Designer Agent" icon="image">
    Creates eye-catching thumbnails with AI image generation, A/B tests different designs, and optimizes for click-through rate using DALL-E or Replicate.
  </Accordion>

  <Accordion title="SEO Optimizer Agent" icon="chart-line">
    Researches high-performing keywords, optimizes titles and descriptions, manages tags and metadata for maximum discoverability.
  </Accordion>

  <Accordion title="Publishing & Scheduling Agent" icon="calendar">
    Uploads videos automatically to YouTube, schedules for optimal times based on analytics, and manages playlists and end screens.
  </Accordion>

  <Accordion title="Analytics & Optimization Agent" icon="chart-bar">
    Tracks performance metrics, identifies successful content patterns, and continuously optimizes strategy based on real data.
  </Accordion>
</AccordionGroup>

## Quick Start

<Steps>
  <Step title="Install Dependencies">
    Clone the repository and install Node.js dependencies

    ```bash theme={null}
    git clone https://github.com/darkzOGx/youtube-automation-agent.git
    cd youtube-automation-agent
    npm install
    ```
  </Step>

  <Step title="Configure Credentials">
    Run the interactive setup wizard to configure your API keys

    ```bash theme={null}
    npm run setup
    ```

    You'll need YouTube Data API credentials (free) and either OpenAI or Google Gemini API keys.
  </Step>

  <Step title="Start the System">
    Launch the automation agent and access the dashboard

    ```bash theme={null}
    npm start
    ```

    Open [http://localhost:3456](http://localhost:3456) to view the dashboard and monitor your automated channel.
  </Step>
</Steps>

## Use Cases

<CardGroup cols={3}>
  <Card title="Educational Channels" icon="graduation-cap">
    Automate tutorial and explainer videos
  </Card>

  <Card title="News Channels" icon="newspaper">
    Generate daily news summaries automatically
  </Card>

  <Card title="Story Channels" icon="book">
    Create animated story content
  </Card>

  <Card title="Gaming Channels" icon="gamepad">
    Generate game guides and tips
  </Card>

  <Card title="Tech Reviews" icon="laptop">
    Automate product reviews and comparisons
  </Card>

  <Card title="Compilation Content" icon="list">
    Create "Top 10" style videos
  </Card>
</CardGroup>

## AI Provider Options

<Tabs>
  <Tab title="Google Gemini (Free)">
    **Best for:** Beginners and hobby creators

    * Free tier: 60 requests/minute
    * Can generate multiple videos daily at no cost
    * Perfect for testing and small channels

    ```bash theme={null}
    # Add to .env
    GEMINI_API_KEY=your-gemini-key-here
    ```
  </Tab>

  <Tab title="OpenAI (Recommended)">
    **Best for:** Professional creators wanting highest quality

    * GPT-4 for intelligent content generation
    * DALL-E 3 for stunning thumbnails
    * Cost: \~\$0.10-0.30 per video

    ```bash theme={null}
    # Add to .env
    OPENAI_API_KEY=your-openai-key-here
    ```
  </Tab>

  <Tab title="Custom Integration">
    **Best for:** Advanced users with specific needs

    * Support for Anthropic Claude
    * Local models via Ollama
    * Any OpenAI-compatible API

    See [Custom AI Providers](/configuration/ai-providers) for integration guide.
  </Tab>
</Tabs>

## Deployment Options

<CardGroup cols={2}>
  <Card title="Run Locally" icon="computer" href="/deployment/local">
    Run on your PC/Mac completely free - perfect for getting started
  </Card>

  <Card title="Cloud VPS" icon="cloud" href="/deployment/vps">
    Deploy on DigitalOcean, Linode, or AWS for 24/7 automation (\$5-20/month)
  </Card>

  <Card title="Cloud Platforms" icon="server" href="/deployment/cloud">
    Use Railway, Render, or Vercel with pay-per-use pricing
  </Card>

  <Card title="Raspberry Pi" icon="microchip" href="/deployment/local">
    Low-power home automation for around \$50 one-time cost
  </Card>
</CardGroup>

## What's Inside

<CardGroup cols={2}>
  <Card title="Get Started" icon="rocket" href="/quickstart">
    Quick setup guide to get your first video generated in minutes
  </Card>

  <Card title="Core Features" icon="star" href="/features/ai-agents">
    Deep dive into each AI agent and what it does
  </Card>

  <Card title="Configuration" icon="gear" href="/configuration/getting-api-keys">
    Step-by-step guide to getting all required API keys
  </Card>

  <Card title="API Reference" icon="code" href="/api/overview">
    Complete REST API documentation and agent class reference
  </Card>
</CardGroup>

<Note>
  **Cost Breakdown**: Run completely FREE with Google Gemini's free tier, or \$6-50/month with OpenAI for premium quality. YouTube API quota is free up to 10,000 units/day.
</Note>