# 🎬🚀 ShortGPT
[](https://opensource.org/licenses/MIT)
[](https://discord.gg/uERx39ru3R)
[](https://star-history.com/#rayventura/shortgpt)
[](https://twitter.com/RayVenturaHQ)
<div align="center">
<img src="https://github.com/RayVentura/ShortGPT/assets/121462835/d9f87cf2-021d-4b8d-bb86-b3a7af1d80d4" alt="ShortGPT-logo" style="border-radius: 20px;" width="22%"/>
</div>
<div align="center">
<a href="https://discord.gg/uERx39ru3R">
<img src="https://img.shields.io/badge/discord-join%20chat-blue.svg" alt="Join our Discord" height="34">
</a>
</div>
⚡ Automating video and short content creation with AI ⚡
## 📝 Introduction to ShortGPT
ShortGPT is a powerful tool for automating content creation. It simplifies video creation, footage sourcing, voiceover synthesis, and editing tasks.
- 🎞️ **Automated editing framework**: Streamlines the video creation process with an LLM oriented video editing language.
- 📃 **Scripts and Prompts**: Provides ready-to-use scripts and prompts for various LLM automated editing processes.
- 🗣️ **Voiceover / Content Creation**: Supports multiple languages including English 🇺🇸, Spanish 🇪🇸, Arabic 🇦🇪, French 🇫🇷, Polish 🇵🇱, German 🇩🇪, Italian 🇮🇹, and Portuguese 🇵🇹.
- 🔗 **Caption Generation**: Automates the generation of video captions.
- 🌐🎥 **Asset Sourcing**: Sources images and video footage from the internet, connecting with the web and Pexels API as necessary.
- 🧠 **Memory and persistency**: Ensures long-term persistency of automated editing variables with TinyDB.
## Showcase
https://github.com/RayVentura/ShortGPT/assets/121462835/d357ba50-51d7-4c1c-a7ba-72d8353a804d
# Instructions for running shortGPT
This guide provides step-by-step instructions for installing ImageMagick and FFmpeg on your system, which are both required to do automated editing. Once installed, you can proceed to run `shortgptUI.py` successfully.
## Prerequisites
Before you begin, ensure that you have the following prerequisites installed on your system:
- Python 3.x
- Pip (Python package installer)
## Installation Steps
Follow the instructions below to install ImageMagick, FFmpeg, and clone the shortGPT repository:
### Step 1: Install ImageMagick
1. For `Windows` download the installer from the official ImageMagick website and follow the installation instructions.
[https://imagemagick.org/script/download.php](https://imagemagick.org/script/download.php)
2. For Ubuntu/Debian-based systems, use the command:
```
sudo apt-get install imagemagick
```
For macOS using Homebrew, use the command:
```
brew install imagemagick
```
2. Verify the installation by running the following command:
```
convert --version
```
You should see the ImageMagick version information if the installation was successful.
### Step 2: Install FFmpeg
1. For `Windows`Download the FFmpeg binaries from the official website and add the executable to your system's PATH.
[https://ffmpeg.org/download.html](https://ffmpeg.org/download.html)
2. For macOS using Homebrew, use the command:
```
brew install ffmpeg
```
For Ubuntu/Debian-based systems, use the command:
```
sudo apt-get install ffmpeg
```
2. Verify the installation by running the following command:
```
ffmpeg -version
```
You should see the FFmpeg version information if the installation was successful.
### Step 3: Clone the shortGPT Repository
1. Open a terminal or command prompt.
2. Execute the following command to clone the shortGPT repository:
```
git clone https://github.com/rayventura/shortgpt.git
```
### Step 4: Install Python Dependencies
1. Open a terminal or command prompt.
2. Navigate to the directory where `shortgpt.py` is located (the cloned repo).
3. Execute the following command to install the required Python dependencies:
```
pip install -r requirements.txt
```
This command will install the necessary packages specified in the `requirements.txt` file.
## Running shortgptUI.py Web Interface
Once you have successfully installed ImageMagick, FFmpeg, and the Python dependencies, you can run `shortgpt.py` by following these steps:
1. Open a terminal or command prompt.
2. Navigate to the directory where `shortgptUI.py` is located (the cloned repo).
3. Execute the following command to run the script:
```
python shortgptUI.py
```
4. After running the script, a Gradio interface should open at your local host on port 31415 (http://localhost:31415).
## Putting API Keys
The ShortGPT UI needs you to input at least OpenAI and ElevenLabs api keys for running short automations. For video automations, you will also need to add a Pexels API.
Follow these steps to add your OpenAI and ElevenLabs API keys:
1. Open [http://localhost:31415/?__theme=light](http://localhost:31415/?__theme=light) from a web browser.
2. Click on the `config` tab located at the left side bar of the user interface.
3. Add your `OPENAI API KEY` and `ELEVENLABS API KEY` in the corresponding input fields.
4. Click `Save` to save your API keys.
That's it! You have successfully set up your API keys and can now utilize the functionality of ShortGPT in the Gradio interface.
## 💁 Contributing
As an open-source project in a rapidly developing field, we are extremely open to contributions, whether it be in the form of a new feature, improved infrastructure, or better documentation.
## Framework overview
- 🎬 The `ContentShortEngine` is designed for creating shorts, handling tasks from script generation to final rendering, including adding YouTube metadata.
- 🎥 The `ContentVideoEngine` is ideal for longer videos, taking care of tasks like generating audio, automatically sourcing background video footage, timing captions, and preparing background assets.
- 🎞️ The automated `EditingEngine`, using Editing Markup Language and JSON, breaks down the editing process into manageable and customizable blocks, comprehensible to Large Language Models.
💡 ShortGPT offers customization options to suit your needs, from language selection to watermark addition.
🔧 As a framework, ShortGPT is adaptable and flexible, offering the potential for efficient, creative content creation.
More documentation incomming, please be patient.
## Technologies Used
ShortGPT utilizes the following technologies to power its functionality:
- **Moviepy**: Moviepy is used for video editing, allowing ShortGPT to make video editing and rendering
- **Openai**: Openai is used for automating the entire process, including generating scripts and prompts for LLM automated editing processes.
- **ElevenLabs**: ElevenLabs is used for voice synthesis, supporting multiple languages for voiceover creation.
- **Pexels**: Pexels is used for sourcing background footage, allowing ShortGPT to connect with the web and access a wide range of images and videos.
- **Bing Image**: Bing Image is used for sourcing images, providing a comprehensive database for ShortGPT to retrieve relevant visuals.
These technologies work together to provide a seamless and efficient experience in automating video and short content creation with AI.
## 🔗 Get in touch on Twitter 🐦
Keep up with the latest happenings, announcements, and insights about Short-GPT by checking out our Twitter accounts. Spark a conversation with our developer and the AI's own account for fascinating dialogues, latest news about the project, and more.
- **Developer**: Stay updated [@RayVentura](https://twitter.com/RayVenturaHQ). Deep-dive into behind-the-scenes, project news, and related topics from the person behind ShortGPT.
We're eager to interact with you and listen to your feedback, concepts, and experiences with Auto-GPT. Come on board on Twitter and let's navigate the future of AI as a team! 💡🤖
<p align="center">
<a href="https://star-history.com/#ReyVentura/ShortGPT&Date">
<img src="https://api.star-history.com/svg?repos=RayVentura/ShortGPT&type=Date" alt="Star History Chart">
</a>
</p>
Raw data
{
"_id": null,
"home_page": "",
"name": "ShortGPT",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "python,video,content creation,AI,automation,editing,voiceover synthesis,video captions,asset sourcing,tinyDB",
"author": "RayVentura",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/83/ce/a78675c880c1e4d89f80ab2f3c823416e8841f94fea5628617140b38b5dc/ShortGPT-0.0.1.tar.gz",
"platform": null,
"description": "\n\n\n# \ud83c\udfac\ud83d\ude80 ShortGPT\n\n[](https://opensource.org/licenses/MIT)\n\n[](https://discord.gg/uERx39ru3R)\n\n[](https://star-history.com/#rayventura/shortgpt)\n\n[](https://twitter.com/RayVenturaHQ) \n\n<div align=\"center\">\n\n <img src=\"https://github.com/RayVentura/ShortGPT/assets/121462835/d9f87cf2-021d-4b8d-bb86-b3a7af1d80d4\" alt=\"ShortGPT-logo\" style=\"border-radius: 20px;\" width=\"22%\"/>\n\n</div>\n\n\n\n<div align=\"center\">\n\n <a href=\"https://discord.gg/uERx39ru3R\">\n\n <img src=\"https://img.shields.io/badge/discord-join%20chat-blue.svg\" alt=\"Join our Discord\" height=\"34\">\n\n </a>\n\n</div>\n\n\n\n\u26a1 Automating video and short content creation with AI \u26a1\n\n\n\n## \ud83d\udcdd Introduction to ShortGPT \n\nShortGPT is a powerful tool for automating content creation. It simplifies video creation, footage sourcing, voiceover synthesis, and editing tasks.\n\n\n\n- \ud83c\udf9e\ufe0f **Automated editing framework**: Streamlines the video creation process with an LLM oriented video editing language.\n\n\n\n- \ud83d\udcc3 **Scripts and Prompts**: Provides ready-to-use scripts and prompts for various LLM automated editing processes.\n\n\n\n- \ud83d\udde3\ufe0f **Voiceover / Content Creation**: Supports multiple languages including English \ud83c\uddfa\ud83c\uddf8, Spanish \ud83c\uddea\ud83c\uddf8, Arabic \ud83c\udde6\ud83c\uddea, French \ud83c\uddeb\ud83c\uddf7, Polish \ud83c\uddf5\ud83c\uddf1, German \ud83c\udde9\ud83c\uddea, Italian \ud83c\uddee\ud83c\uddf9, and Portuguese \ud83c\uddf5\ud83c\uddf9.\n\n\n\n- \ud83d\udd17 **Caption Generation**: Automates the generation of video captions.\n\n\n\n- \ud83c\udf10\ud83c\udfa5 **Asset Sourcing**: Sources images and video footage from the internet, connecting with the web and Pexels API as necessary.\n\n\n\n- \ud83e\udde0 **Memory and persistency**: Ensures long-term persistency of automated editing variables with TinyDB.\n\n\n\n\n\n## Showcase\n\n\n\n\n\nhttps://github.com/RayVentura/ShortGPT/assets/121462835/d357ba50-51d7-4c1c-a7ba-72d8353a804d\n\n\n\n\n\n# Instructions for running shortGPT\n\n\n\nThis guide provides step-by-step instructions for installing ImageMagick and FFmpeg on your system, which are both required to do automated editing. Once installed, you can proceed to run `shortgptUI.py` successfully.\n\n\n\n## Prerequisites\n\n\n\nBefore you begin, ensure that you have the following prerequisites installed on your system:\n\n- Python 3.x\n\n- Pip (Python package installer)\n\n\n\n## Installation Steps\n\n\n\nFollow the instructions below to install ImageMagick, FFmpeg, and clone the shortGPT repository:\n\n\n\n### Step 1: Install ImageMagick\n\n\n\n1. For `Windows` download the installer from the official ImageMagick website and follow the installation instructions.\n\n \n\n [https://imagemagick.org/script/download.php](https://imagemagick.org/script/download.php)\n\n \n\n \n\n2. For Ubuntu/Debian-based systems, use the command:\n\n ```\n\n sudo apt-get install imagemagick\n\n ``` \n\n For macOS using Homebrew, use the command:\n\n ```\n\n brew install imagemagick\n\n ```\n\n\n\n2. Verify the installation by running the following command:\n\n ```\n\n convert --version\n\n ```\n\n\n\n You should see the ImageMagick version information if the installation was successful.\n\n\n\n### Step 2: Install FFmpeg\n\n\n\n1. For `Windows`Download the FFmpeg binaries from the official website and add the executable to your system's PATH. \n\n \n\n [https://ffmpeg.org/download.html](https://ffmpeg.org/download.html)\n\n \n\n2. For macOS using Homebrew, use the command:\n\n ```\n\n brew install ffmpeg\n\n ``` \n\n For Ubuntu/Debian-based systems, use the command:\n\n ```\n\n sudo apt-get install ffmpeg\n\n ```\n\n2. Verify the installation by running the following command:\n\n ```\n\n ffmpeg -version\n\n ```\n\n\n\n You should see the FFmpeg version information if the installation was successful.\n\n\n\n### Step 3: Clone the shortGPT Repository\n\n\n\n1. Open a terminal or command prompt.\n\n2. Execute the following command to clone the shortGPT repository:\n\n ```\n\n git clone https://github.com/rayventura/shortgpt.git\n\n ```\n\n\n\n### Step 4: Install Python Dependencies\n\n\n\n1. Open a terminal or command prompt.\n\n2. Navigate to the directory where `shortgpt.py` is located (the cloned repo).\n\n3. Execute the following command to install the required Python dependencies:\n\n ```\n\n pip install -r requirements.txt\n\n ```\n\n\n\n This command will install the necessary packages specified in the `requirements.txt` file.\n\n\n\n## Running shortgptUI.py Web Interface\n\n\n\nOnce you have successfully installed ImageMagick, FFmpeg, and the Python dependencies, you can run `shortgpt.py` by following these steps:\n\n\n\n1. Open a terminal or command prompt.\n\n2. Navigate to the directory where `shortgptUI.py` is located (the cloned repo).\n\n3. Execute the following command to run the script:\n\n ```\n\n python shortgptUI.py\n\n ```\n\n4. After running the script, a Gradio interface should open at your local host on port 31415 (http://localhost:31415). \n\n\n\n## Putting API Keys\n\nThe ShortGPT UI needs you to input at least OpenAI and ElevenLabs api keys for running short automations. For video automations, you will also need to add a Pexels API.\n\n\n\nFollow these steps to add your OpenAI and ElevenLabs API keys:\n\n\n\n1. Open [http://localhost:31415/?__theme=light](http://localhost:31415/?__theme=light) from a web browser. \n\n2. Click on the `config` tab located at the left side bar of the user interface.\n\n3. Add your `OPENAI API KEY` and `ELEVENLABS API KEY` in the corresponding input fields.\n\n4. Click `Save` to save your API keys.\n\n\n\nThat's it! You have successfully set up your API keys and can now utilize the functionality of ShortGPT in the Gradio interface.\n\n\n\n## \ud83d\udc81 Contributing\n\n\n\nAs an open-source project in a rapidly developing field, we are extremely open to contributions, whether it be in the form of a new feature, improved infrastructure, or better documentation.\n\n\n\n## Framework overview\n\n\n\n- \ud83c\udfac The `ContentShortEngine` is designed for creating shorts, handling tasks from script generation to final rendering, including adding YouTube metadata.\n\n\n\n- \ud83c\udfa5 The `ContentVideoEngine` is ideal for longer videos, taking care of tasks like generating audio, automatically sourcing background video footage, timing captions, and preparing background assets.\n\n \n\n- \ud83c\udf9e\ufe0f The automated `EditingEngine`, using Editing Markup Language and JSON, breaks down the editing process into manageable and customizable blocks, comprehensible to Large Language Models.\n\n\n\n\ud83d\udca1 ShortGPT offers customization options to suit your needs, from language selection to watermark addition.\n\n\n\n\ud83d\udd27 As a framework, ShortGPT is adaptable and flexible, offering the potential for efficient, creative content creation.\n\n\n\nMore documentation incomming, please be patient.\n\n\n\n## Technologies Used\n\n\n\nShortGPT utilizes the following technologies to power its functionality:\n\n\n\n- **Moviepy**: Moviepy is used for video editing, allowing ShortGPT to make video editing and rendering\n\n\n\n- **Openai**: Openai is used for automating the entire process, including generating scripts and prompts for LLM automated editing processes.\n\n\n\n- **ElevenLabs**: ElevenLabs is used for voice synthesis, supporting multiple languages for voiceover creation.\n\n\n\n- **Pexels**: Pexels is used for sourcing background footage, allowing ShortGPT to connect with the web and access a wide range of images and videos.\n\n\n\n- **Bing Image**: Bing Image is used for sourcing images, providing a comprehensive database for ShortGPT to retrieve relevant visuals.\n\n\n\nThese technologies work together to provide a seamless and efficient experience in automating video and short content creation with AI.\n\n\n\n## \ud83d\udd17 Get in touch on Twitter \ud83d\udc26\n\n\n\nKeep up with the latest happenings, announcements, and insights about Short-GPT by checking out our Twitter accounts. Spark a conversation with our developer and the AI's own account for fascinating dialogues, latest news about the project, and more.\n\n\n\n- **Developer**: Stay updated [@RayVentura](https://twitter.com/RayVenturaHQ). Deep-dive into behind-the-scenes, project news, and related topics from the person behind ShortGPT.\n\n\n\nWe're eager to interact with you and listen to your feedback, concepts, and experiences with Auto-GPT. Come on board on Twitter and let's navigate the future of AI as a team! \ud83d\udca1\ud83e\udd16\n\n\n\n<p align=\"center\">\n\n <a href=\"https://star-history.com/#ReyVentura/ShortGPT&Date\">\n\n <img src=\"https://api.star-history.com/svg?repos=RayVentura/ShortGPT&type=Date\" alt=\"Star History Chart\">\n\n </a>\n\n</p>\n\n",
"bugtrack_url": null,
"license": "",
"summary": "Automating video and short content creation with AI",
"version": "0.0.1",
"project_urls": null,
"split_keywords": [
"python",
"video",
"content creation",
"ai",
"automation",
"editing",
"voiceover synthesis",
"video captions",
"asset sourcing",
"tinydb"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "51aba2789d17fff3f28f8d91ae898050dc0913ce24dd2f067193fe8436122e5b",
"md5": "5e7dba646f513dc8241d6a62c7fdcb87",
"sha256": "448be123840d7d8bf61e514cf6da9db2cb0aea338b49fa990fba95ad13420d5e"
},
"downloads": -1,
"filename": "ShortGPT-0.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "5e7dba646f513dc8241d6a62c7fdcb87",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 37509,
"upload_time": "2023-07-11T17:37:32",
"upload_time_iso_8601": "2023-07-11T17:37:32.778218Z",
"url": "https://files.pythonhosted.org/packages/51/ab/a2789d17fff3f28f8d91ae898050dc0913ce24dd2f067193fe8436122e5b/ShortGPT-0.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "83cea78675c880c1e4d89f80ab2f3c823416e8841f94fea5628617140b38b5dc",
"md5": "8c195a3f199d0f65ca8d81967c0297d9",
"sha256": "e7c1b8a93a5a63bb08a95f50146c7b3db545368aa883556bd517e867dc3bcf6d"
},
"downloads": -1,
"filename": "ShortGPT-0.0.1.tar.gz",
"has_sig": false,
"md5_digest": "8c195a3f199d0f65ca8d81967c0297d9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 25934,
"upload_time": "2023-07-11T17:37:34",
"upload_time_iso_8601": "2023-07-11T17:37:34.383070Z",
"url": "https://files.pythonhosted.org/packages/83/ce/a78675c880c1e4d89f80ab2f3c823416e8841f94fea5628617140b38b5dc/ShortGPT-0.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-07-11 17:37:34",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "shortgpt"
}
JSON