AI Tools · 6 min read
AgentTube Setup Guide: The Open-Source AI That Runs a YouTube Channel
AgentTube is a free, MIT-licensed repo that researches, scripts, voices, edits, and publishes YouTube videos, then learns from your analytics. Here is the honest setup guide: from zero to a running dashboard in one evening, on the free Gemini API.
"Key Takeaways"
- AgentTube (github.com/darkzOGx/youtube-automation-agent) is an open-source AI pipeline that runs a YouTube channel end to end: research, script, voiceover, visuals, thumbnail, upload prep.
- After every upload it reads CTR, retention, and watch time, and adjusts the next video. It also splits long-form videos into Shorts.
- Setup takes one evening and $0: Node.js, four terminal commands, and a free Gemini API key.
- It automates production, not income. And the tool is completely free — any crypto token or paid access sold around it is a scam.
Summarize this article with
Running a YouTube channel is six jobs: researcher, scriptwriter, voice artist, editor, thumbnail designer, and the person who reads analytics at midnight. AgentTube is an open-source project — 3,400+ GitHub stars, MIT license — that collapses those six jobs into one pipeline you supervise.
This is the setup guide we promised. It assumes nothing: if you have never opened a terminal, start at step one and type along.
What it actually does
- You give it one channel goal, like grow a faceless personal-finance channel. Its agents plan a content calendar around it.
- Per video: researches the topic, writes the script, generates narration and visuals, assembles the video, creates the thumbnail, writes the title and description, and preps the upload.
- After a video goes live, it reads CTR, retention, and watch time, and uses that data to change what the next video does. This compounding loop is the whole point.
- It can split approved long-form videos into Shorts and track the exact second viewers drop off.
- Approval-first by default: nothing is scheduled or published until you say yes. Self-hosted: your API keys and channel data stay on your machine.
Setup from zero (one evening)
- Install Node.js 18 or newer from nodejs.org — the big green download button, then next-next-finish.
- Open your terminal (Terminal on Mac, PowerShell on Windows) and run: git clone https://github.com/darkzOGx/youtube-automation-agent.git
- Then: cd youtube-automation-agent, then npm install, then npm run walkthrough
- Open localhost:3456 in your browser. The walkthrough explains each provider choice, tests your credentials, and guides YouTube authorization step by step.
- Get your free API key at aistudio.google.com (Google Gemini, no card required). OpenAI, OpenRouter, Kimi, and GLM keys also work — the system auto-configures any OpenAI-compatible endpoint.
- Before letting it run on its own, open Production Readiness in the dashboard and click Run Verified Check. It live-tests text, narration, YouTube access, and a temporary MP4 without uploading anything to your channel.
A channel goal worth pasting
The quality of the whole pipeline follows from the goal you give the operator. Vague goal, vague channel. Paste something with an audience, pillars, cadence, and guardrails:
Channel goal: build a faceless personal-finance channel for young professionals in India. Audience: 22-32, first salary to first crore, prefers plain language over jargon. Content pillars: 1) money mistakes and how to avoid them 2) how common financial products actually work 3) salary, tax and investing basics explained simply. Cadence: one 6-8 minute long-form per week plus Shorts cut from it. Tone: warm, specific, zero hype, always give one actionable step. Guardrails: no stock tips, no crypto signals, no income promises, cite sources for every statistic, flag anything that needs a disclaimer. Optimize for retention and saves, not clickbait.
Read this before you dream in ad revenue
AgentTube automates production, not income. YouTube ad revenue still requires the Partner Program thresholds: 1,000 subscribers and 4,000 public watch hours (or 10M Shorts views in 90 days). The analytics loop grinds toward that; it does not skip it.
Keep approval-first switched on. YouTube enforces its inauthentic-content policy, and low-effort spam channels get demonetized. This tool is a production assistant, not a spam cannon — review every video before it publishes.
The tool is 100% free under the MIT license. There is a crypto token circulating around this project's hype. Ignore it. Anyone selling AgentTube coins, paid access, or a premium unlock is scamming you.
Three tips from actually running it
Pick one niche you can feed weekly. The compounding loop only compounds if uploads keep coming; a channel that publishes erratically gives the analytics agent nothing to learn from.
Start on the free Gemini tier and stay there for your first ten videos. Upgrade providers only when you know what the channel needs — paid video generation is the expensive part, and the built-in checks warn you before any paid probe runs.
Let it split every long-form into Shorts. Same production effort, two surfaces earning watch time, and the drop-off tracking tells you which segments deserve to become Shorts in the first place.
Quick questions
Is it really free?
The software is free and MIT-licensed, and the free Gemini API tier is enough to start. You pay only if you opt into paid providers for premium AI video generation — and the dashboard asks before any paid call.
Do I need to know how to code?
No. If you can copy four commands into a terminal, the built-in walkthrough handles everything else in the browser at localhost:3456.
Will YouTube ban AI-generated channels?
YouTube's policy targets inauthentic, mass-produced spam — not AI tooling itself. Channels that add real value, review before publishing, and disclose synthetic media where required are operating within the rules. That is exactly why approval-first matters.
How long until it earns?
Honestly: months, not days. You need 1,000 subscribers and 4,000 watch hours for ad revenue. The tool removes the production bottleneck so you can publish consistently — consistency and niche choice do the rest.
Get the repo
Everything above is one clone away. Set it up this weekend, give it a goal with real guardrails, and review the first video it hands you over your Sunday chai.
Open AgentTube on GitHub