Loading repository dataβ¦
Loading repository dataβ¦
oguzemirtopuz / repository
π¬ An autonomous AI content engine that conceptualizes short-form videos, splits high-action scenes using computer vision, and renders "Top 5" compilations via FFmpeg.
A transparent discovery signal based on current public GitHub metadata.
This score does not audit code, security, maintainers, documentation quality, or suitability. Verify the repository and its current documentation before adoption.
Short-form content (TikToks, Shorts, Reels) is a full-time job disguised as a 60-second video.
The typical "Top 5" or ranking video workflow looks like this:
This process takes 3β5 hours per video. For a channel that needs to post daily, that's unsustainable.
RankVibe Automation eliminates the entire manual editing pipeline. Give it your channel's topic, and it handles the rest β from concept to rendered MP4.
RankVibe Automation Pipeline
β
βββ Stage 1: AI Concept Engine (OpenRouter API)
β βββ Analyzes channel rules and last video metrics
β βββ Generates viral concept ideas using LLMs
β βββ Formulates optimized YouTube search queries
β
βββ Stage 2: Video Acquisition
β βββ YouTube search for raw compilation footage
β βββ yt-dlp download pipeline
β βββ Local cache in downloads/
β
βββ Stage 3: Computer Vision Scene Splitter (OpenCV)
β βββ Frame-by-frame brightness delta analysis
β βββ Action scene transition detection
β βββ Clip boundary identification
β βββ Preview clips written to clips/
β
βββ Stage 4: Creator Dashboard (FastAPI + Web UI)
β βββ Visual clip grid β preview all detected scenes
β βββ Drag-to-select: choose 5 clips for the final video
β βββ Custom ordering (#5 to #1 reverse countdown)
β
βββ Stage 5: Video Stitcher (FFmpeg Pipeline)
βββ Resolution scaling to target format (9:16 or 16:9)
βββ Transition rendering between clips
βββ Background audio overlay and sync
βββ Final MP4 output to final_videolar/
Tech Stack:
| Layer | Technology |
|---|---|
| Backend | Python 3.10 Β· FastAPI Β· Uvicorn |
| AI Integration | OpenRouter API (LLM model selection) |
| Computer Vision | OpenCV (frame analysis + scene detection) |
| Video Processing | FFmpeg (stitching, scaling, encoding, audio sync) |
| Frontend Dashboard | HTML5 Β· Vanilla JavaScript Β· CSS3 |
| Video Acquisition | yt-dlp |
All sensitive data is excluded from the repository:
.env β API keys and configurationsvenv/ β Python environment binaries*.mp4, *.mp3 β raw download caches*.log β diagnostic outputRankVibe Automation requires ffmpeg and ffprobe to stitch, scale, transitions, and sync audio/video clips.
Open Command Prompt (CMD) or PowerShell and run:
winget install Gyan.FFmpeg
Note: Restart your terminal, CMD, or editor after the installation finishes to apply the system PATH changes.
bin/ folder, and copy ffmpeg.exe and ffprobe.exe..exe files directly into the root directory of this project (next to launcher.pyw).Install via your system's package manager:
# macOS (Homebrew)
brew install ffmpeg
# Ubuntu / Debian
sudo apt update && sudo apt install ffmpeg
pip install -r requirements.txt
Obtain a free API key from OpenRouter and create a .env file:
OPENROUTER_API_KEY=your-api-key-here
# Double-click run.bat, or:
python launcher.pyw
Open the local URL in your browser β select a concept, watch the pipeline run, pick your 5 clips, and render your video.
Contributions welcome. Priority areas:
MIT License β see LICENSE for details.