darkzOGx/youtube-automation-agent

What it solves

This project provides an end-to-end automation pipeline for running a YouTube channel. It removes the manual effort of researching topics, writing scripts, producing media assets, and managing the publishing schedule, while maintaining human oversight through an approval-first workflow.

How it works

The system uses a series of specialized AI agents to handle different stages of the content lifecycle:

• Content Strategy Agent: Analyzes trends to plan a content calendar.
• Script Writer Agent: Creates hooks, narratives, and calls to action.
• Thumbnail Designer Agent: Generates thumbnails and A/B variations.
• SEO Optimizer Agent: Handles keywords, titles, and descriptions.
• Production Management Agent: Coordinates text-to-speech (TTS) audio, image assets, and video assembly using FFmpeg.
• Publishing & Scheduling Agent: Manages the upload and scheduling of approved videos to YouTube.
• Analytics & Optimization Agent: Tracks performance and feeds insights back into the strategy agent.

Who it’s for

Content creators and channel owners who want to automate the production of their YouTube videos while retaining control over quality and rights management.

Highlights

• Approval-First Workflow: No content is scheduled or published without passing human-review gates.
• Provider Flexibility: Supports a wide range of AI providers including OpenAI, Gemini, OpenRouter, Kimi, MiMo, and GLM.
• Self-Hosted: Keeps credentials and channel data under the user's control.
• Graceful Fallbacks: If premium API keys are missing, the system can simulate production steps or use gradient-based visuals to keep the pipeline moving.