darkzOGx/youtube-automation-agent

โ˜… 4,983โ‘‚ 1,592

๐ŸŽฌ Open-source, self-hosted AI agent that runs a YouTube channel end to end: researches topics, writes scripts, generates narration, visuals and video, optimizes SEO

About darkzOGx/youtube-automation-agent

darkzOGx/youtube-automation-agent is an open-source project on GitHub, mainly written in JavaScript. ๐ŸŽฌ Open-source, self-hosted AI agent that runs a YouTube channel end to end: researches topics, writes scripts, generates narration, visuals and video It currently holds 4,983 stars and 1,592 forks with 22 open issues, and was last pushed on 2026-10-27 (repository created 2025-08-14).

Project Overview

Git Homed tracks it on the Video Trending board and on the AI Video Trending list.

GitHub Repository Details

Repository darkzOGx/youtube-automation-agent ยท default branch master ยท size 2165 KB ยท watchers 75 ยท source: GitHub REST API and repository README

README

YouTube Automation Agent

The open-source AI agent that runs a YouTube channel end to end, with you approving every video before it goes out.

It researches topics, writes scripts, generates narration and visuals, assembles real MP4s, writes titles, descriptions and tags, schedules approved videos, and learns from analytics and from what your audience says. It runs on your own machine with your own API keys.

CI MIT License Node.js 18.17+ Releases

The operator console: videos waiting for your decision, a generation job in progress, and the publishing calendar

| Content review: quality checks, metadata, and the approve, save, reject, and regenerate actions for one video | Autonomous operator: the channel mandate, the current run, and the editorial plan the agent decided to make | | :--: | :--: | | Content review: quality checks and approval for one video | Autonomous operator: your mandate and the agent's plan |

Screenshots use sample data so every panel is populated. Regenerate them with npm run docs:screenshots.

Why it's different

Quick start

You need:

git clone https://github.com/darkzOGx/youtube-automation-agent.git
cd youtube-automation-agent
npm install
npx playwright install chromium   # renders slideshow videos; on Linux add --with-deps
npm run walkthrough
npm start

Then open http://localhost:3456.

1. npm run walkthrough explains each provider choice, tests your keys, and connects your YouTube channel. For a shorter flow, use npm run setup. Every setting is documented in .env.example. 2. Check readiness. In the dashboard, open Production readiness and choose Run verified check. It makes small live text and narration requests, checks access to your channel, and builds and decodes a test MP4, without uploading anything. 3. Make videos. Open Autonomous operator, describe the channel you want, and choose Activate & run now, or create a single video from the dashboard. Finished videos wait in Pipeline for your review and approval.

FFmpeg is installed with npm install through ffmpeg-static.

YouTube credentials

1. Create a project in Google Cloud Console. 2. Enable YouTube Data API v3, and YouTube Analytics API for retention and outcome data. 3. Create an OAuth 2.0 client of type Desktop app (not Web application) and save the JSON as config/credentials.json. 4. Under Google Auth Platform โ†’ Audience, add the Google account that owns your channel as a test user. Otherwise sign-in fails with Error 403: access_denied. While the app is in Testing mode, Google expires the sign-in after 7 days.

How it works

| Stage | What the agent does | What you control | | --- | --- | --- | | Research | Finds topics and builds a content strategy | Niche, audience, blocked topics | | Script | Writes the hook, narrative, CTA, and metadata | Voice, format, length, brand direction | | Production | Generates narration and visuals, then assembles a real MP4 | Provider choice and media fallbacks | | Review | Runs quality checks and opens the video for review | Facts, media rights, edits, approval | | Publish | Schedules and uploads approved content | Privacy, timing, final decision | | Learn | Captures 24-hour and 7-day evidence, measures your chosen outcome, then proposes the next move | Choose the KPI and approve or reject each lesson |

Features

Each item links to its walkthrough in the feature guide.

Plan

Produce Review Learn Engage

AI providers

One key gets you started. Pick a text provider in the walkthrough: Gemini, OpenAI, OpenRouter (400+ models, including Claude), Kimi, MiMo, GLM, DeepSeek, or MiniMax. Gemini has free tiers for text and narration.

Models, keys, env vars, clip limits, and the .env essentials are in the providers guide.

Automation

The scheduler starts with npm start and uses the server's local time.

| When | What runs | | --- | --- | | Daily at 06:00 | Content generation, following the active channel strategy's cadence | | Every 15 minutes | Publishing queue | | Daily at 09:00 | Analytics collection | | Daily at 22:00 | Optimization | | Every 4 hours | Comment sync and growth-experiment refresh | | Sundays at 08:00 | Weekly strategy review |

Details are in the feature guide.

Docs

The three problems people hit most:

| Problem | Fix | | --- | --- | | Missing credentials for: an AI provider | Configure any one text provider with npm run walkthrough. OpenAI isn't required. | | Google sign-in shows Error 403: access_denied | Add your Google account as a test user under Google Auth Platform โ†’ Audience. | | No video is produced, or it's marked simulated | Read the โœ— lines in the startup capability check, and make sure you ran npx playwright install chromium. |

Questions and setup help go in Discussions.

Contributing

See CONTRIBUTING.md for ground rules, project structure, and how to add a provider. Short version: one focused concern per PR, no lockfile churn, lint and tests must pass. Issues are for bugs.

git clone 
cd youtube-automation-agent
npm install
npm run lint   # CI runs this on every PR
npm test

Made something real with it? Share verified output in examples.

Built by

@darkzOGx, a solo builder shipping AI automation and developer tools. Find me on X and laderalabs.io. If YouTube Automation Agent saves you time, a star helps it reach more developers.

License

MIT. See LICENSE. Model and API acknowledgments are in the providers guide.

This tool is for legitimate content creation. Comply with YouTube's Terms of Service and Community Guidelines.

---

More from darkzOGx:

GitHub Stars & Activity

4,983Stars
1,592Forks
22Open issues
JavaScriptLanguage

GitHub Popularity

GitHub stars4,983
Forks1,592
Open issues22
Primary languageJavaScript
LicenseMIT
Stars gained today0
Created2025-08-14
Last pushed2026-10-27

Trending History

Trending statusnot on today's boards

Related GitHub Projects

1

alyssaxuu / screenity

JavaScriptโ˜… 18,998โ‘‚ 0
โ†’
2

lemomo-ai / lemo-opuscar

JavaScriptโ˜… 17,510โ‘‚ 0
โ†’
3

aandrew-me / ytDownloader

JavaScriptโ˜… 10,694โ‘‚ 0
โ†’
4

LaoFeng-mouse / flyingmouse-format

JavaScriptโ˜… 7,125โ‘‚ 0
โ†’
5

kaomei / stickman-video-director

JavaScriptโ˜… 6,696โ‘‚ 0
โ†’
6

vvo / gifify

JavaScriptโ˜… 6,331โ‘‚ 0
โ†’
7

spite / ccapture.js

JavaScriptโ˜… 3,782โ‘‚ 0
โ†’
8

Kagami / ffmpeg.js

JavaScriptโ˜… 3,462โ‘‚ 0
โ†’

More Trending Repositories