explaingit

rayventura/shortgpt

7,330PythonAudience · vibe coderComplexity · 3/5Setup · moderate

TLDR

A Python framework that automatically produces short-form videos for YouTube Shorts and TikTok, from AI-written scripts to voiceovers, auto-sourced footage, captions, and final video export, with no manual editing required.

Mindmap

mindmap
  root((repo))
    What it does
      Video automation
      Short form content
      AI powered
    Engines
      Shorts engine
      Video engine
      Translation engine
    Tech Stack
      Python
      OpenAI
      MoviePy
      EdgeTTS
    Use Cases
      TikTok videos
      YouTube Shorts
      Video dubbing
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Automatically generate a TikTok-style short video from a topic idea, with AI script, voiceover, stock footage, and captions in one run

USE CASE 2

Dub an existing YouTube video into another language by giving ShortGPT the URL, it transcribes, translates, re-voices, and exports a dubbed version

USE CASE 3

Batch-produce YouTube Shorts on multiple topics with AI-generated scripts and auto-sourced background visuals

Tech stack

PythonOpenAIMoviePyDockerEdgeTTSElevenLabsPexels

Getting it running

Difficulty · moderate Time to first run · 1h+

Requires an OpenAI API key, Docker recommended for consistent dependency setup.

In plain English

ShortGPT is a Python framework that automates the process of creating short-form videos for platforms like YouTube Shorts and TikTok. Instead of manually writing scripts, recording voiceovers, finding footage, and editing clips together, you describe what you want and the framework handles the production steps automatically using AI. The framework has several distinct engines depending on what you are making. The shorts engine handles everything from generating a script to final video output, including adding the metadata needed to post on YouTube. The video engine handles longer content, automatically sourcing background footage, timing captions, and preparing audio. A translation engine takes an existing video or YouTube link, transcribes what is said, translates it into another language, generates a new voiceover, and outputs a completely dubbed video. Voiceover generation supports over 30 languages through Microsoft's EdgeTTS service, with ElevenLabs as an alternative for higher quality voice synthesis. Background visuals are sourced automatically from Pexels (a library of free stock footage and photos) and Bing Image search. Captions are generated and timed automatically. The underlying scripts and editing instructions are produced by OpenAI's language models, which also drive decisions about pacing and structure. Video processing is handled by a Python library called MoviePy. You can run ShortGPT locally using Docker, which packages all the dependencies so the setup is consistent regardless of your system. A Google Colab notebook is also available if you want to try it without installing anything on your own computer. Colab is a free cloud service that runs Python notebooks in a browser.

Copy-paste prompts

Prompt 1
I want to use ShortGPT to create a 60-second YouTube Short about the history of coffee. Walk me through setting up the framework with Docker and running the shorts engine to produce a complete video file.
Prompt 2
I have a YouTube video URL and I want ShortGPT to dub it into Spanish using Microsoft EdgeTTS. Show me the Python code to call the translation engine and export the dubbed video.
Prompt 3
I want to use ElevenLabs instead of the default EdgeTTS voice in ShortGPT for higher quality audio. Show me how to configure my ElevenLabs API key and select a voice for voiceover generation.
Prompt 4
I want to run ShortGPT in Google Colab without installing anything locally. What steps do I follow to open the Colab notebook, add my API keys, and generate a first video?
Open on GitHub → Explain another repo

← rayventura on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.