youtube-automation-agent
🎬 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, and publishes after your approval, then learns from analytics. Works with Gemini, OpenAI, OpenRouter, DeepSeek and more.
⭐ 4,489 stars on GitHub · 🍴 1,440 forks · 📜 License: mit · 💻 Language: JavaScript
What is youtube-automation-agent?
A self-hosted media server — turn your NAS/VPS into a personal cinema. Stream movies & music to your household without subscription dependency.
Main components
- Autonomous Channel Operator: give it an objective, audience, content pillars, cadence, and limits. It researches trends and competitors, builds an evidence-labeled plan, and sends each video throug...
- Outcome & ROI Studio: set a target (views, watch hours, net subscribers, engagement, or revenue) and a budget, and track progress. Missing data shows as unavailable, never as zero.
- Production readiness: a verified check of every provider, your channel, and video assembly before anything runs on its own. Paid image and video probes are separate opt-ins.
- Resumable generation: every stage is checkpointed, so a crash or timeout resumes where it stopped instead of starting over.
- AI video generation: local slideshow by default; Seedance, MiniMax H3, Gemini Omni, Kling, or Wan for real clips, with a cap on paid seconds.
- Shorts Repurposing Studio: turn an approved video into three 9:16 Short drafts with burned-in captions, reusing existing media so no new generation credits are spent.
- Content review: quality checks, metadata editing, approval, and scheduling for each video.
- Scene Repair Studio: edit, reorder, lock, replace, or regenerate a single scene, then rebuild the video.
The biggest strength is offline-first streaming + ad-free + unlimited library scaled by your disk size.
Best for families building home theaters, small hotels streaming internal media, creators archiving work.
Topics: the project is tagged with popular topics:
- 🏷️
ai-agents - 🏷️
automation - 🏷️
content-automation - 🏷️
content-creation - 🏷️
content-strategy - 🏷️
google-gemini - 🏷️
javascript - 🏷️
nodejs - 🏷️
openai - 🏷️
self-hosted
Quick install
See the README for detailed install instructions. Most projects support Docker — if the repo has a Dockerfile, use:
git clone https://github.com/darkzOGx/youtube-automation-agent.git
cd youtube-automation-agent
docker build -t youtube-automation-agent .
docker run -d -p 8080:8080 youtube-automation-agent
Minimum system requirements
| Component | Recommended |
|---|---|
| RAM | 1024 MB |
| CPU | 1 vCPU |
| Disk | 15 GB SSD |
| OS | Ubuntu 22.04 LTS / Debian 12 |
| Docker | 24.0+ |
⚡ Deploy fast on VSIS
Use the VSIS VPS Mini 1GB RAM / 1 vCPU / 15GB SSD (~70k/tháng) plan from VSIS.NET — high-speed VN-based VPS, 24/7 support, ideal for running youtube-automation-agent smoothly.
🎯 Benefits:
- One-command
docker compose up -ddeploy in 2 minutes - Dedicated IPv4, root access, unmetered domestic bandwidth
- Daily snapshot backup
- Free install assistance from the VSIS team
👉 See matching VPS plans at vsis.net
Resources
- 🔗 GitHub: darkzOGx/youtube-automation-agent
- 🌐 Homepage: https://github.com/darkzOGx/youtube-automation-agent#readme
- 📚 Official docs: see README in the repo
- 💬 Community: GitHub Issues + Discussions
Article compiled from GitHub data on 20/10/2026. Star/fork counts may have changed — see live numbers via the GitHub link.