YouTube Automation Agent
darkzOGx/youtube-automation-agentReviewed by AI
Checked by RepoPicks Radar on
What is YouTube Automation Agent?
YouTube Automation Agent is a program you run on your own machine with a web dashboard. It researches topics, writes the script, generates the narration and the pictures, assembles an MP4, writes the title, description and tags, and leaves each video waiting for your approval before it is scheduled and uploaded to your channel. Afterwards it reads your YouTube statistics and comments and suggests changes. You need Node.js, a Google Cloud project with the YouTube API switched on, and a key for at least one AI service.
How easy is it to install YouTube Automation Agent?
C · install 1 or 2 tools · Windows
- Windows C
- macOS C
- Linux C
A C on Windows, Mac and Linux: none of the 5 releases has a file to download, so you install Node.js 18.17 or newer, then `git clone`, `npm install`, `npx playwright install chromium` (on Linux with `--with-deps`), `npm run walkthrough` and `npm start`, and open `http://localhost:3456`. FFmpeg comes with `npm install`. The slow part is outside the terminal: creating a project in Google Cloud Console, switching on two YouTube APIs, making a Desktop-app OAuth client, saving it as `config/credentials.json` and adding your own Google account as a test user, after which Google expires the sign-in every 7 days.
YouTube Automation Agent on GitHub
- Stars
- 5,126on Nov 10, 2026
- Downloads
- —all releases
- Growth
- +131stars in 6 days
Stars over time
Facts
- Runs on
- Windows, macOS, Linux
- You need to install
- Node.js, FFmpeg
- To build from source
- Node.js, FFmpeg
- Disk space
- 100 MB–500 MB · estimate
- Accounts or keys
- One text AI service: Gemini, OpenAI, OpenRouter, Kimi, MiMo, GLM, DeepSeek or MiniMax, YouTube Data API v3 and YouTube Analytics API, as a Google Cloud "Desktop app" OAuth client, ElevenLabs or Azure Speech for better narration (optional), Replicate, MiniMax, Kling or Alibaba DashScope for generated video clips (optional)
- Cost
- Free, API costs extra · The code is MIT and nothing is charged for it, but it does not work without a key for at least one AI service. The README says Gemini has free tiers for text and narration, and the default video is a slideshow built on your own machine; ElevenLabs narration and the five video generators (Seedance, MiniMax H3, Gemini Omni, Kling, Wan) are paid by the second, which is why there are settings to cap them.
- License
- MIT (Permissive)
- Last change on GitHub
- Oct 27, 2026
YouTube Automation Agent risk signals (7)
- Attentiona channel that publishes by itself
The schedule in the README runs "Daily at 06:00 Content generation", a publishing queue "Every 15 minutes" and an "Autonomous operator" you activate with "Activate & run now", with `.env.example` capping it at `GLOBAL_RATE_LIMIT_PER_HOUR=50`. YouTube's rules on mass-produced and repetitive content put channels that publish this way at risk of losing monetisation or being removed, and the README's own closing line asks you to "Comply with YouTube's Terms of Service and Community Guidelines".
AI review
- Attentiondashboard can be left open on the network
`.env.example` says "The dashboard listens on this machine only by default. Use HOST=0.0.0.0 to reach it from other devices, and set API_KEY below when you do", and ships `API_KEY=` empty, with the protection described as optional: "If set, mutating API routes require this value in the x-api-key header". Whoever opens the port without filling the key hands anyone on that network the routes that generate videos and upload to the channel.
AI review
- Infopermission to upload to your channel sits on the machine
Setup asks for an OAuth 2.0 client of type "Desktop app" saved as `config/credentials.json`, with YouTube Data API v3 and YouTube Analytics API switched on. From then on the program holds standing permission to post on your channel and read its figures, and the dependency `@google-cloud/local-auth` stores the sign-in on disk.
AI review
- Infoit answers your viewers
The Audience Engagement Studio offers "reply drafts that post only after you approve them", and `.env.example` sets a ceiling of `ENGAGEMENT_DAILY_REPLY_CAP=50` replies a day. The comments under your videos can therefore be written by the AI, with no sign to the reader.
AI review
- Infopaid seconds add up quietly
Generated clips are billed by the provider, which is why the settings exist: `VIDEO_MAX_GENERATED_SECONDS=60`, `VIDEO_CLIP_DURATION=8`, `MAX_CONCURRENT_JOBS=1` with the comment "Optional. Generation jobs run one at a time by default to control API spend", plus "Paid image and video probes are separate opt-ins". No price per video appears anywhere in the repository.
AI review
- Infothe install brings a whole browser
`npx playwright install chromium` downloads a complete Chromium to render the slideshow videos, and `ffmpeg-static` adds a bundled FFmpeg; the finished MP4s and uploads then pile up in `./uploads` (`MAX_FILE_SIZE=52428800`). The disk estimate in the checks is a guess.
AI review
- Infocan call a script from another repository
`.env.example` has `DARKZSEO_PYTHON=python` and `DARKZSEO_PATH=../darkzseo/darkzseo.py` for the "Discoverability preflight", described as "bundled and advisory; external checkout is explicit and falls back safely". If you point it there, Node runs a Python file from the author's separate darkzseo project, and you need Python installed.
AI review
Evidence is shown in its original language.
What Radar could not check about YouTube Automation Agent
- Whether the finished videos are watchable, since the screenshots "use sample data"
- What a video really costs in text, narration, image and clip fees
- Whether YouTube keeps accepting a channel fed this way, and what it does to monetisation
- Whether the whole chain works on each system, including the `playwright install chromium` step
- How much disk the browser, FFmpeg, the generated media and the analytics database take