How darkzogx/youtube-automation-agent works
YouTube Automation Agent is a self-hosted system that researches channel topics, creates and assembles videos, holds them for human review, publishes approved content, and learns from channel outcomes. The local dashboard and server form the operator entry point; documented features also include scene repair, Shorts, discoverability checks, audience engagement, and controlled growth experiments. The map preserves these branches, but several are represented by their directory because their implementation was not excerpted. Relationships use README workflow statements or SOURCE INDEX references; unsampled wiring is not inferred.
Main entry points: index.js Application server · content-strategy-agent.js Topic strategy · script-writer-agent.js Script writer · channel-learning-engine.js Channel learning
Components 25
Operator console
- Dashboard
dashboard/app.js - Application server
index.js - Channel database
database/db.js - Operator controls
utils/operator-service.js
Planning and writing
- Topic strategy
agents/content-strategy-agent.js - Channel operator
utils/autonomous-channel-operator.js - Script writer
agents/script-writer-agent.js - Text generation
utils/ai-text-service.js - SEO metadata
agents/seo-optimizer-agent.js
Video production
- Production manager
agents/production-management-agent.js - Video generation
utils/ai-video-generator.js - Media provider routing
utils/media-generation-service.js - Video providers
utils/video-providers.js - Scene repair
utils/scene-repair-service.js - Shorts repurposing
utils/shorts-repurposing-service.js
Review and publishing
- Human approval
index.js - Publishing scheduler
agents/publishing-scheduling-agent.js - Discoverability checks
utils/discoverability-service.js
Learning and growth
- Audience engagement
utils/audience-engagement-service.js - Analytics optimizer
agents/analytics-optimization-agent.js - Channel learning
utils/channel-learning-engine.js - Scene retention
utils/scene-retention-engine.js - Growth experiments
utils/growth-experiment-service.js
Other components
- Channel owner
- YouTube
Connections 30
- Channel owner → Dashboard: operates
README.md - Dashboard → Application server: requests
index.js - Application server → Channel database: reads and writes
index.js - Application server → Topic strategy: initializes
index.js - Application server → Script writer: initializes
index.js - Application server → Production manager: runs jobs
index.js - Application server → Publishing scheduler: routes publishing
index.js - Application server → Channel operator: routes operator
index.js - Application server → Operator controls: uses controls
index.js - Channel operator → Topic strategy: plans topics
README.md - Topic strategy → Text generation: generates strategy
agents/content-strategy-agent.js - Script writer → Text generation: generates scripts
agents/script-writer-agent.js - Topic strategy → Script writer: feeds production
README.md - Script writer → SEO metadata: creates metadata
README.md - Production manager → Video generation: generates media
agents/production-management-agent.js - Video generation → Media provider routing: requests clips
utils/ai-video-generator.js - Media provider routing → Video providers: routes generation
utils/media-generation-service.js - Production manager → Scene repair: enables repair
agents/production-management-agent.js - Channel owner → Human approval: reviews content
README.md - Human approval → Publishing scheduler: approves scheduling
README.md - Publishing scheduler → YouTube: uploads approved
README.md - Human approval → Discoverability checks: runs preflight
README.md - Human approval → Shorts repurposing: repurposes approved
README.md - YouTube → Analytics optimizer: provides outcomes
README.md - Analytics optimizer → Channel learning: proposes lessons
agents/analytics-optimization-agent.js - Channel learning → Scene retention: analyzes scenes
utils/channel-learning-engine.js - Channel learning → Growth experiments: informs tests
README.md - Channel owner → Channel learning: approves lessons
README.md - YouTube → Audience engagement: supplies comments
README.md - Audience engagement → Channel owner: presents reply drafts
README.md