Repolode
Submit
darkzOGx

darkzOGx/youtube-automation-agent

Self-hosted AI agent that runs a YouTube channel end to end, from research and scripts to rendered videos, with your approval before upload.

View on GitHubWebsite
Stars
5,054
Forks
1,614
Open issues
22
Last commit
12 days ago

What is it?

YouTube Automation Agent is a self-hosted Node.js application that handles the production side of a YouTube channel. It researches topics, drafts scripts, generates narration and visuals, assembles MP4 videos, and writes titles, descriptions and tags. Approved videos are scheduled and uploaded through the YouTube Data API.

Every finished video passes fact review, media-rights confirmation and your explicit approval before publishing, and autonomous mode does not skip these checks. Simulated or placeholder media is clearly marked and cannot be approved or uploaded. Lessons drawn from analytics, retention curves and comments are proposed for your sign-off before they affect future videos.

The agent works with several text providers, including Gemini, OpenAI, OpenRouter, DeepSeek, Kimi, GLM and MiniMax, and with multiple AI video providers. Local slideshow rendering is the default, so no paid video generation happens unless you enable it. A web dashboard and HTTP API run on your machine with your own keys.

Key features

  • 01Researches topics and builds a content strategy from a niche and audience you define.
  • 02Writes scripts, titles, descriptions and tags, then assembles real MP4 videos.
  • 03Generates narration with ElevenLabs, OpenAI or Gemini, and visuals with OpenAI or Gemini image models.
  • 04Requires fact review, media-rights confirmation and approval before any upload.
  • 05Schedules approved videos and uploads them via the YouTube Data API.
  • 06Tracks analytics and proposes lessons for you to approve.

Use cases

  • Running a faexplanatory or list-style YouTube channel with a small team or as a solo creator.
  • Producing a steady stream of Shorts from an approved long-form video.
  • Testing title and thumbnail variants on live videos before committing to one.
  • Prototyping an automated content pipeline while keeping human review in the loop.

Quick start

  1. 1

    Clone the repository

    git clone https://github.com/darkzOGx/youtube-automation-agent.git
  2. 2

    Enter the project folder and install dependencies

    cd youtube-automation-agent && npm install
  3. 3

    Install the Chromium browser used for slideshow rendering

    npx playwright install chromium
  4. 4

    Run the setup walkthrough to configure keys and connect YouTube, then start the app and open http://localhost:3456

    npm run walkthrough

Things to know

  • You need your own API keys, and a Google Cloud project with YouTube API credentials.
  • Real AI video clips and images require paid provider keys; the default is free local slideshow rendering.
  • Google sign-in expires every 7 days while the OAuth app is in Testing mode.

In collections

AI video generationOpen-source AI agent frameworks & appsSelf-hosted appsAI video & audio tools

Topics

#ai-agents#youtube-automation#content-creation#video-generation#self-hosted#nodejs#llm#seo-optimization#automation#content-automation

FAQ

What is youtube-automation-agent?
Self-hosted AI agent that runs a YouTube channel end to end, from research and scripts to rendered videos, with your approval before upload. YouTube Automation Agent is a self-hosted Node.js application that handles the production side of a YouTube channel. It researches topics, drafts scripts, generates narration and visuals, assembles MP4 videos, and writes titles, descriptions and tags. Approved videos are scheduled and uploaded through the YouTube Data API.
Is youtube-automation-agent free to use? What license does it have?
youtube-automation-agent is open source under the MIT license. Check the license terms before using it in commercial products.
Is youtube-automation-agent still maintained?
Actively maintained. The last commit to youtube-automation-agent was on Oct 27, 2026.
What can I use youtube-automation-agent for?
Running a faexplanatory or list-style YouTube channel with a small team or as a solo creator. Producing a steady stream of Shorts from an approved long-form video. Testing title and thumbnail variants on live videos before committing to one. Prototyping an automated content pipeline while keeping human review in the loop.
How do I install youtube-automation-agent?
Clone the repository: git clone https://github.com/darkzOGx/youtube-automation-agent.git Enter the project folder and install dependencies: cd youtube-automation-agent && npm install Install the Chromium browser used for slideshow rendering: npx playwright install chromium Run the setup walkthrough to configure keys and connect YouTube, then start the app and open http://localhost:3456: npm run walkthrough
Where can I get youtube-automation-agent?
The source code and installation instructions are on GitHub: https://github.com/darkzOGx/youtube-automation-agent

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects