🤖 Agentic AI · Open Source · Production Ready
Python 3.10+ Flask DeepSeek / Gemini / Groq 29 Python files 79 API routes 20/20 Tests Passing MIT License

The AI That Runs
Your YouTube Channel

APEX is a fully autonomous AI agent that writes scripts, generates videos, uploads to YouTube, tracks analytics, and improves — all without manual work.

⬇ Download on GitHub 📖 See How It Works
29Python Files
79API Routes
17Dashboard Pages
20/20Tests Passing
3Animation Tiers

What APEX does

Everything a YouTube team does — automated

One command starts it. Nova handles the rest.

✍️

AI Script Writing

LLM writes complete comedy sketches for Trishul, Sandy, and Libhu — original characters you own 100%. Copyright-safe. SEO-optimised titles, tags, and descriptions included.

🎬

Video Generation

Generates real .mp4 files — AI cartoon images per scene, voice narration, Ken Burns motion effects, and on-screen captions. Three animation tiers from free to professional.

🔒

Approval Gate

Every upload is blocked until you explicitly approve. Payload-locked cards — any metadata change invalidates the approval. 20-point quality gate runs automatically.

📊

Analytics + Improvement

Connects to YouTube Analytics API. Tracks views, CTR, and retention per video. Enhancement engine uses real data to improve the next video automatically.

🧠

Nova AI Persona

Conversational AI interface with memory, voice, desktop control, and browser automation. Talk to Nova in real time — she executes tasks immediately.

⏰

Daily Scheduler

Queues new episodes automatically every morning. Topic pool cycles through your content plan. Enhancement brief applied to each video. You approve every upload.


End-to-end flow

From topic to YouTube in one command

Every step verified by the E2E test suite. All 5 wiring gaps found in external audit — fixed and proven.

💬

You say: "make a video about X"

Nova detects the intent from chat, voice, or hands-free wake word "Hey Nova"

✍️

Script Engine

LLM writes 6-7 scene comedy sketch with Trishul, Sandy, Libhu. Copyright scanner blocks any licensed character names automatically.

🎨

Image Engine

Pollinations.ai generates cartoon-style AI images per scene. Free, unlimited. Ideogram and Leonardo as paid alternatives.

🎙️

Voice Engine

gTTS records narration for each scene. Google WaveNet available for human-quality voice.

🎬

Video Builder

MoviePy renders final .mp4 with Ken Burns zoom effects, captions, and audio sync. Manim or Kling AI if installed.

✅

Quality Gate (20 checks)

Scene count, narration length, copyright scan, image integrity, video file size — all checked automatically before reaching approval.

🔐

YOUR APPROVAL

Approval card shows exact metadata. Payload-locked — any change invalidates it. You click Approve. No upload without this.

📤

YouTube Upload

Official YouTube Data API v3. Title, tags, description, thumbnail, visibility, made-for-kids flag all set. Analytics auto-registered.

🔄

Enhancement Loop

YouTube Analytics fetched after upload. Enhancement engine generates improvement brief. Next video uses real performance data.


Animation system

3 tiers — free to professional

APEX auto-selects the best available tier on every run. No manual switching.

🆓

Tier 1 — Narrated Slideshow

ALWAYS ACTIVE · FREE FOREVER

Works immediately with zero setup. AI-generated cartoon images per scene with voice narration and Ken Burns zoom effects.

🆓

Tier 2 — Manim 2D Animation

FREE FOREVER · pip install manim

Smooth 2D animated scenes — the same animation engine used by 3Blue1Brown (4M+ subscribers). Free forever, no GPU needed.

pip install manim
winget install MiKTeX.MiKTeX  # Windows only
# Restart APEX — Manim activates automatically
💰

Tier 3 — Kling AI / Pika Labs / Runway ML

PAID · ₹1,200-1,500/month · Real cartoon animation

Real animated cartoon clips per scene. Characters actually move. Near Cartoon Network quality. Add one API key to activate.

ProviderFree TrialPaidQualityGet Key
Kling AI66 free clips~₹1,500/mo⭐⭐⭐⭐⭐klingai.com
Pika LabsFree trial~₹1,200/mo⭐⭐⭐⭐pika.art
Runway MLFree credits~₹1,500/mo⭐⭐⭐⭐⭐runwayml.com
# In APEX dashboard → Settings → API Keys
KLING_API_KEY = "your-kling-key-here"
# Save → APEX uses Kling on every future video automatically

Quick start

Running in 3 commands

One-shot installer handles everything. Python is the only prerequisite.

# 1. Clone
git clone https://github.com/sachiii143/apex-youtube-agent.git
cd apex-youtube-agent

# 2. Run one-shot installer
# Installs: venv, all packages, ffmpeg, Ollama, Playwright
# Asks for: free API keys, YouTube OAuth (guided)
PowerShell -ExecutionPolicy Bypass -File "run_nova.ps1"

# 3. Browser opens at http://127.0.0.1:5000
# Nova greets you by voice. Say "make a video" to start.
Free
Base tier cost
2 min
DeepSeek key setup
20 min
YouTube OAuth (once)
10 sec
Every future start

Built with

Technology stack

LayerTechnologyPurpose
BackendPython 3.10+ · Flask · Flask-SockAPI server, job queue, WebSocket push
AI BrainDeepSeek · Gemini · Groq · OllamaScript writing, chat, decision making
ImagesPollinations.ai · Ideogram · LeonardoAI image generation per scene
VoicegTTS · Google WaveNet · Web SpeechNarration + TTS output + voice input
VideoMoviePy · Manim · Kling AI · Pika3-tier animation rendering
YouTubeYouTube Data API v3 · OAuth2Upload, analytics, thumbnails
Desktoppyautogui · Playwright · PillowScreenshot, mouse control, browser
DatabaseSQLite (WAL mode)Memory, jobs, analytics, audit log
FrontendVanilla JS · CSS custom properties17-page dashboard, no framework needed
Testsunittest · E2E integration tests20 tests covering full pipeline

What's next

Roadmap

v1.0

Full YouTube pipeline

Script → Video → Upload → Analytics → Improvement loop. 29 files, 79 routes, 20/20 tests.

v1.0

3-tier animation system

Narrated slideshow (free) + Manim 2D (free) + Kling/Pika/Runway (paid)

v1.0

Nova AI persona

Memory, voice, hands-free wake word, desktop control, browser automation

v1.1

NEXUS — Affiliate Marketing Agent

ClickBank, CJ, Digi24 integration. Auto-select niche, generate content, post to all social platforms. Market Mirror Loop — competitor intelligence.

v1.1

YouTube Shorts auto-generation

Extract best scenes from each video, crop 9:16, add captions, upload as Shorts

v1.1

Multi-client channel management

Manage multiple YouTube channels from one dashboard. Client reporting export.

v2.0

Full character animation

Lip-synced Trishul, Sandy, Libhu with rigged models. True cartoon quality at scale.

v2.0

Multi-language support

Tamil, Hindi, English content generation. Regional market targeting.

v2.0

SaaS packaging

Deploy APEX as a hosted service. Client onboarding, billing, multi-tenant architecture.

S
Built by
Sachin.M
AI Developer · YouTube Automation · Agentic Systems
29
Python Files
79
API Routes
20/20
Tests Pass

Start your autonomous YouTube channel today

Free to use. One command to install. Daily videos on autopilot. You approve every upload.

⬇ Download on GitHub 📖 Full Setup Guide