https://github.com/paillat-dev/viralfactory
Viral Factory is a highly modular gradio app that automates the production of various forms of social media content. Thanks to it's complex engines system it allows you to customize its process in detail.
https://github.com/paillat-dev/viralfactory
ai content-creation content-creation-auto gradio tiktok youtube youtube-automation
Last synced: 4 months ago
JSON representation
Viral Factory is a highly modular gradio app that automates the production of various forms of social media content. Thanks to it's complex engines system it allows you to customize its process in detail.
- Host: GitHub
- URL: https://github.com/paillat-dev/viralfactory
- Owner: Paillat-dev
- License: agpl-3.0
- Created: 2024-02-12T15:07:50.000Z (over 1 year ago)
- Default Branch: dev
- Last Pushed: 2025-06-16T20:37:39.000Z (4 months ago)
- Last Synced: 2025-06-16T21:37:54.513Z (4 months ago)
- Topics: ai, content-creation, content-creation-auto, gradio, tiktok, youtube, youtube-automation
- Language: Python
- Homepage:
- Size: 730 KB
- Stars: 49
- Watchers: 4
- Forks: 8
- Open Issues: 20
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
Viral Factory 
Viral Factory is a highly modular gradio app that automates the production of various forms of social media content. Thanks to it's complex engines system it allows you to customize it's process in detail.
Report Bug
.
Request Feature
## Table Of Contents
* [About the Project](#about-the-project)
* [Built With](#built-with)
* [Getting Started](#getting-started)
* [Prerequisites](#prerequisites)
* [Installation](#installation)
* [Usage](#usage)
* [Roadmap](#roadmap)
* [Contributing](#contributing)
* [License](#license)
* [Authors](#authors)
* [Acknowledgements](#acknowledgements)
## About The Project
Viral Factory is a **highly modular** [gradio](https://github.com/gradio-app/gradio) app that **automates** the production of various forms of **social media content** with custom pipelines to allow for custom usage.
It can handle, **notably:**
- Writing scripts
- Text to Speech
- Assets retrieval
- Video Backgrounds
- Audio Backgrounds
- Upload to TikTok and YouTube
## Built With
Thiw project was built with ❤️ and with
* [Gradio](https://github.com/gradio-app/gradio)
* [🐸TTS](https://github.com/coqui-ai/TTS)
* [moviepy](https://github.com/Zulko/moviepy)
* [whisper-timestamped](https://github.com/linto-ai/whisper-timestamped)
## Getting Started
### Prerequisites
Currently, an Nvidia gpu with at least around 10 GB of vram is required for this project to work in optimal conditions, and at minima 20 GB of free disk storage.
You will need as well to have the following software installed (click on them to install):
- [CUDA 11.8](https://developer.nvidia.com/cuda-11-8-0-download-archive)
- [ffmpeg](https://ffmpeg.org/download.html)
- [git](https://git-scm.com/downloads)
- [Python 3.10](https://www.python.org/downloads/release/python-31011/)
- [PDM](https://pdm-project.org/en/latest/)
### Installation
Once the above requirements are installed, reboot your computer. Then, open a terminal window, navigate to where you want to install the project and run, one line at a time the following:
```bash
git clone https://github.com/Paillat-dev/viralfactory
cd viralfactory
pdm install
# or for development
pdm install --dev
```
This might take some time, you should not worry about it seeming stuck.
## Usage
You can launch the webapp with:
```bash
pdm run start
```
Watch the video below to learn more on how to use.
[](https://youtu.be/9jQa1LjbPJI)
## Roadmap
See the [open issues](https://github.com/Paillat-dev/viralfactory/issues) for a list of proposed features (and known issues).
## Contributing
Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are **greatly appreciated**.
* If you have suggestions, feel free to [open an issue](https://github.com/Paillat-dev/viralfactory/issues/new) to discuss it.
* Please make sure you check your **spelling and grammar**.
* Create individual PR for each suggestion.
### Creating A Pull Request
1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. Commit your Changes (`git commit -m '✨feat(Engines.LLMEngine) Add ollama local engine'`)
4. Push to the Branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request
## Star history
## License
Distributed under the AGPL-3.0 license. See [LICENSE](/LICENSE) for more information
## Authors
* **Paillat-dev** - [Paillat-dev](https://paillat.dev/) - *Main author*
## Acknowledgements
* [ShaanCoding](https://github.com/ShaanCoding/)
* [Othneil Drew](https://github.com/othneildrew/Best-README-Template)
* [ImgShields](https://shields.io/)
* [RayVentura/ShortGPT](https://github.com/RayVentura/ShortGPT)