diff --git a/README.md b/README.md index 6dfee6b..7830327 100644 --- a/README.md +++ b/README.md @@ -12,7 +12,7 @@ Demo GIF

-## Disclaimer +## Disclaimer This deepfake software is designed to be a productive tool for the AI-generated media industry. It can assist artists in animating custom characters, creating engaging content, and even using models for clothing design. @@ -32,14 +32,16 @@ Users are expected to use this software responsibly and legally. If using a real ## Exclusive v2.0 Quick Start - Pre-built (Windows) - + ##### This is the fastest build you can get if you have a discrete NVIDIA or AMD GPU. - + ###### These Pre-builts are perfect for non-technical users or those who don't have time to, or can't manually install all the requirements. Just a heads-up: this is an open-source project, so you can also install it manually. This will be 60 days ahead on the open source version. ## TLDR; Live Deepfake in just 3 Clicks + ![easysteps](https://github.com/user-attachments/assets/af825228-852c-411b-b787-ffd9aac72fc6) + 1. Select a face 2. Select which camera to use 3. Press live! @@ -103,17 +105,25 @@ Users are expected to use this software responsibly and legally. If using a real
Click to see the process +## App Design + +

+ App Design +
+ App Design, created with CodeViz +

+ ### Installation This is more likely to work on your computer but will be slower as it utilizes the CPU. **1. Set up Your Platform** -- Python (3.10 recommended) -- pip -- git -- [ffmpeg](https://www.youtube.com/watch?v=OlNWCpFdVMA) - ```iex (irm ffmpeg.tc.ht)``` -- [Visual Studio 2022 Runtimes (Windows)](https://visualstudio.microsoft.com/visual-cpp-build-tools/) +- Python (3.10 recommended) +- pip +- git +- [ffmpeg](https://www.youtube.com/watch?v=OlNWCpFdVMA) - `iex (irm ffmpeg.tc.ht)` +- [Visual Studio 2022 Runtimes (Windows)](https://visualstudio.microsoft.com/visual-cpp-build-tools/) **2. Clone the Repository** @@ -125,7 +135,7 @@ cd Deep-Live-Cam **3. Download the Models** 1. [GFPGANv1.4](https://huggingface.co/hacksider/deep-live-cam/resolve/main/GFPGANv1.4.pth) -2. [inswapper\_128\_fp16.onnx](https://huggingface.co/hacksider/deep-live-cam/resolve/main/inswapper_128_fp16.onnx) +2. [inswapper_128_fp16.onnx](https://huggingface.co/hacksider/deep-live-cam/resolve/main/inswapper_128_fp16.onnx) Place these files in the "**models**" folder. @@ -133,14 +143,16 @@ Place these files in the "**models**" folder. We highly recommend using a `venv` to avoid issues. - For Windows: + ```bash python -m venv venv venv\Scripts\activate pip install -r requirements.txt ``` + For Linux: + ```bash # Ensure you use the installed Python 3.10 python3 -m venv venv @@ -220,18 +232,20 @@ python3.10 run.py --execution-provider coreml ``` **Important Notes for macOS:** + - You **must** use Python 3.10, not newer versions like 3.11 or 3.13 - Always run with `python3.10` command not just `python` if you have multiple Python versions installed - If you get error about `_tkinter` missing, reinstall the tkinter package: `brew reinstall python-tk@3.10` - If you get model loading errors, check that your models are in the correct folder - If you encounter conflicts with other Python versions, consider uninstalling them: + ```bash # List all installed Python versions brew list | grep python - + # Uninstall conflicting versions if needed brew uninstall --ignore-dependencies python@3.11 python@3.13 - + # Keep only Python 3.10 brew cleanup ``` @@ -280,25 +294,26 @@ pip install onnxruntime-openvino==1.15.0 ```bash python run.py --execution-provider openvino ``` +
## Usage **1. Image/Video Mode** -- Execute `python run.py`. -- Choose a source face image and a target image/video. -- Click "Start". -- The output will be saved in a directory named after the target video. +- Execute `python run.py`. +- Choose a source face image and a target image/video. +- Click "Start". +- The output will be saved in a directory named after the target video. **2. Webcam Mode** -- Execute `python run.py`. -- Select a source face image. -- Click "Live". -- Wait for the preview to appear (10-30 seconds). -- Use a screen capture tool like OBS to stream. -- To change the face, select a new source image. +- Execute `python run.py`. +- Select a source face image. +- Click "Live". +- Wait for the preview to appear (10-30 seconds). +- Use a screen capture tool like OBS to stream. +- To change the face, select a new source image. ## Tips and Tricks @@ -344,32 +359,32 @@ Looking for a CLI mode? Using the -s/--source argument will make the run program **We are always open to criticism and are ready to improve, that's why we didn't cherry-pick anything.** - - [*"Deep-Live-Cam goes viral, allowing anyone to become a digital doppelganger"*](https://arstechnica.com/information-technology/2024/08/new-ai-tool-enables-real-time-face-swapping-on-webcams-raising-fraud-concerns/) - Ars Technica - - [*"Thanks Deep Live Cam, shapeshifters are among us now"*](https://dataconomy.com/2024/08/15/what-is-deep-live-cam-github-deepfake/) - Dataconomy - - [*"This free AI tool lets you become anyone during video-calls"*](https://www.newsbytesapp.com/news/science/deep-live-cam-ai-impersonation-tool-goes-viral/story) - NewsBytes - - [*"OK, this viral AI live stream software is truly terrifying"*](https://www.creativebloq.com/ai/ok-this-viral-ai-live-stream-software-is-truly-terrifying) - Creative Bloq - - [*"Deepfake AI Tool Lets You Become Anyone in a Video Call With Single Photo"*](https://petapixel.com/2024/08/14/deep-live-cam-deepfake-ai-tool-lets-you-become-anyone-in-a-video-call-with-single-photo-mark-zuckerberg-jd-vance-elon-musk/) - PetaPixel - - [*"Deep-Live-Cam Uses AI to Transform Your Face in Real-Time, Celebrities Included"*](https://www.techeblog.com/deep-live-cam-ai-transform-face/) - TechEBlog - - [*"An AI tool that "makes you look like anyone" during a video call is going viral online"*](https://telegrafi.com/en/a-tool-that-makes-you-look-like-anyone-during-a-video-call-is-going-viral-on-the-Internet/) - Telegrafi - - [*"This Deepfake Tool Turning Images Into Livestreams is Topping the GitHub Charts"*](https://decrypt.co/244565/this-deepfake-tool-turning-images-into-livestreams-is-topping-the-github-charts) - Emerge - - [*"New Real-Time Face-Swapping AI Allows Anyone to Mimic Famous Faces"*](https://www.digitalmusicnews.com/2024/08/15/face-swapping-ai-real-time-mimic/) - Digital Music News - - [*"This real-time webcam deepfake tool raises alarms about the future of identity theft"*](https://www.diyphotography.net/this-real-time-webcam-deepfake-tool-raises-alarms-about-the-future-of-identity-theft/) - DIYPhotography - - [*"That's Crazy, Oh God. That's Fucking Freaky Dude... That's So Wild Dude"*](https://www.youtube.com/watch?time_continue=1074&v=py4Tc-Y8BcY) - SomeOrdinaryGamers - - [*"Alright look look look, now look chat, we can do any face we want to look like chat"*](https://www.youtube.com/live/mFsCe7AIxq8?feature=shared&t=2686) - IShowSpeed +- [_"Deep-Live-Cam goes viral, allowing anyone to become a digital doppelganger"_](https://arstechnica.com/information-technology/2024/08/new-ai-tool-enables-real-time-face-swapping-on-webcams-raising-fraud-concerns/) - Ars Technica +- [_"Thanks Deep Live Cam, shapeshifters are among us now"_](https://dataconomy.com/2024/08/15/what-is-deep-live-cam-github-deepfake/) - Dataconomy +- [_"This free AI tool lets you become anyone during video-calls"_](https://www.newsbytesapp.com/news/science/deep-live-cam-ai-impersonation-tool-goes-viral/story) - NewsBytes +- [_"OK, this viral AI live stream software is truly terrifying"_](https://www.creativebloq.com/ai/ok-this-viral-ai-live-stream-software-is-truly-terrifying) - Creative Bloq +- [_"Deepfake AI Tool Lets You Become Anyone in a Video Call With Single Photo"_](https://petapixel.com/2024/08/14/deep-live-cam-deepfake-ai-tool-lets-you-become-anyone-in-a-video-call-with-single-photo-mark-zuckerberg-jd-vance-elon-musk/) - PetaPixel +- [_"Deep-Live-Cam Uses AI to Transform Your Face in Real-Time, Celebrities Included"_](https://www.techeblog.com/deep-live-cam-ai-transform-face/) - TechEBlog +- [_"An AI tool that "makes you look like anyone" during a video call is going viral online"_](https://telegrafi.com/en/a-tool-that-makes-you-look-like-anyone-during-a-video-call-is-going-viral-on-the-Internet/) - Telegrafi +- [_"This Deepfake Tool Turning Images Into Livestreams is Topping the GitHub Charts"_](https://decrypt.co/244565/this-deepfake-tool-turning-images-into-livestreams-is-topping-the-github-charts) - Emerge +- [_"New Real-Time Face-Swapping AI Allows Anyone to Mimic Famous Faces"_](https://www.digitalmusicnews.com/2024/08/15/face-swapping-ai-real-time-mimic/) - Digital Music News +- [_"This real-time webcam deepfake tool raises alarms about the future of identity theft"_](https://www.diyphotography.net/this-real-time-webcam-deepfake-tool-raises-alarms-about-the-future-of-identity-theft/) - DIYPhotography +- [_"That's Crazy, Oh God. That's Fucking Freaky Dude... That's So Wild Dude"_](https://www.youtube.com/watch?time_continue=1074&v=py4Tc-Y8BcY) - SomeOrdinaryGamers +- [_"Alright look look look, now look chat, we can do any face we want to look like chat"_](https://www.youtube.com/live/mFsCe7AIxq8?feature=shared&t=2686) - IShowSpeed ## Credits -- [ffmpeg](https://ffmpeg.org/): for making video-related operations easy -- [deepinsight](https://github.com/deepinsight): for their [insightface](https://github.com/deepinsight/insightface) project which provided a well-made library and models. Please be reminded that the [use of the model is for non-commercial research purposes only](https://github.com/deepinsight/insightface?tab=readme-ov-file#license). -- [havok2-htwo](https://github.com/havok2-htwo): for sharing the code for webcam -- [GosuDRM](https://github.com/GosuDRM): for the open version of roop -- [pereiraroland26](https://github.com/pereiraroland26): Multiple faces support -- [vic4key](https://github.com/vic4key): For supporting/contributing to this project -- [kier007](https://github.com/kier007): for improving the user experience -- [qitianai](https://github.com/qitianai): for multi-lingual support -- and [all developers](https://github.com/hacksider/Deep-Live-Cam/graphs/contributors) behind libraries used in this project. -- Footnote: Please be informed that the base author of the code is [s0md3v](https://github.com/s0md3v/roop) -- All the wonderful users who helped make this project go viral by starring the repo ❤️ +- [ffmpeg](https://ffmpeg.org/): for making video-related operations easy +- [deepinsight](https://github.com/deepinsight): for their [insightface](https://github.com/deepinsight/insightface) project which provided a well-made library and models. Please be reminded that the [use of the model is for non-commercial research purposes only](https://github.com/deepinsight/insightface?tab=readme-ov-file#license). +- [havok2-htwo](https://github.com/havok2-htwo): for sharing the code for webcam +- [GosuDRM](https://github.com/GosuDRM): for the open version of roop +- [pereiraroland26](https://github.com/pereiraroland26): Multiple faces support +- [vic4key](https://github.com/vic4key): For supporting/contributing to this project +- [kier007](https://github.com/kier007): for improving the user experience +- [qitianai](https://github.com/qitianai): for multi-lingual support +- and [all developers](https://github.com/hacksider/Deep-Live-Cam/graphs/contributors) behind libraries used in this project. +- Footnote: Please be informed that the base author of the code is [s0md3v](https://github.com/s0md3v/roop) +- All the wonderful users who helped make this project go viral by starring the repo ❤️ [![Stargazers](https://reporoster.com/stars/hacksider/Deep-Live-Cam)](https://github.com/hacksider/Deep-Live-Cam/stargazers) diff --git a/media/app-design.gif b/media/app-design.gif new file mode 100644 index 0000000..64a07b9 Binary files /dev/null and b/media/app-design.gif differ