|
Download README.md from LiveFaceSwapAI/face-swap-reference-prep: direct link, hf CLI and curl.
- Browser
- Download file 4.67 kB
-
https://huggingface.co/spaces/LiveFaceSwapAI/face-swap-reference-prep/resolve/main/README.md
- Command line
-
hf download hf://spaces/LiveFaceSwapAI/face-swap-reference-prep/README.md
-
curl -L -o README.md https://huggingface.co/spaces/LiveFaceSwapAI/face-swap-reference-prep/resolve/main/README.md
4.67 kB
| title: LiveFaceSwap AI Face Swap Reference Image Prep | |
| emoji: 🖼️ | |
| colorFrom: indigo | |
| colorTo: blue | |
| sdk: static | |
| app_file: index.html | |
| pinned: false | |
| license: mit | |
| short_description: Prepare portrait references for LiveFaceSwap AI face swap. | |
| tags: | |
| - face-swap | |
| - livefaceswap | |
| - image-preprocessing | |
| - portrait | |
| - reference-image | |
| - computer-vision | |
| # LiveFaceSwap AI Face Swap Reference Image Prep | |
| Prepare a clear, consistently sized portrait reference before using it in a | |
| [LiveFaceSwap AI](https://livefaceswap.ai/?utm_source=huggingface&utm_medium=referral&utm_campaign=reference_prep) | |
| real-time face swap workflow. This browser utility fixes EXIF orientation, lets you position a | |
| square crop around the face, converts the result to RGB, removes image metadata, and exports a | |
| 512, 768, or 1024 pixel PNG. | |
| The utility is a transparent **preprocessing step**, not a face swap model. It does not change a | |
| person's identity or generate a face-swapped image. | |
| ## Why prepare a reference image? | |
| Reference photos often arrive rotated, off-center, in inconsistent aspect ratios, or with large | |
| areas that are irrelevant to the portrait. Preparing the file gives the downstream face swap | |
| workflow a predictable square image with the intended face positioned in the frame. This avoids | |
| preventable input-format problems, but it does not guarantee a particular face swap result. | |
| ## LiveFaceSwap workflow | |
| 1. Choose a clear portrait that you own or have permission to use. | |
| 2. Upload it here, select 512, 768, or 1024 pixels, and move the crop focus until the face is centered. | |
| 3. Download the prepared RGB PNG. | |
| 4. Open LiveFaceSwap AI, choose **Face Swap**, and upload the PNG under **Reference**. | |
| 5. Turn on your camera and review the live AI output before using it in a call, recording, or stream. | |
| For the complete product flow, see the | |
| [online face swap guide](https://livefaceswap.ai/guides/live-face-swap-online?utm_source=huggingface&utm_medium=referral&utm_campaign=reference_prep) | |
| or the | |
| [Windows desktop setup guide](https://livefaceswap.ai/guides/live-face-swap-windows-setup?utm_source=huggingface&utm_medium=referral&utm_campaign=reference_prep). | |
| ## Input and output | |
| | | Details | | |
| |---|---| | |
| | Input | One JPG, PNG, or WebP portrait, up to 20 MB | | |
| | Controls | Output size plus horizontal and vertical crop focus | | |
| | Output | Square 512x512, 768x768, or 1024x1024 RGB PNG with normalized orientation and metadata removed | | |
| | Processing | Runs locally in the browser; the selected file is not sent to an application server | | |
| Use **Try synthetic example** in the Space to see a landscape illustration pass through the same | |
| square-crop and PNG-export path without uploading a personal image. | |
| ## Choosing a useful portrait reference | |
| - Prefer one clearly visible, front-facing face with open eyes and a visible facial outline. | |
| - Use even lighting and enough resolution to keep facial details clear after cropping. | |
| - Avoid group photos, heavy blur, extreme angles, strong shadows, and obstructions over the face. | |
| - Keep the entire face inside the square preview and use the focus controls to adjust framing. | |
| - Only use your own face or a portrait you are authorized to process. | |
| ## Frequently asked questions | |
| ### Does this Space perform face swapping? | |
| No. It only prepares a portrait reference. Face swapping happens later in the LiveFaceSwap AI | |
| browser or desktop workflow. | |
| ### Is my portrait uploaded to a server? | |
| No. This static Space decodes, crops, resizes, and exports the selected file inside your browser. | |
| ### Which output size should I use? | |
| 1024x1024 is a practical default when the source image contains enough detail. The 512 and 768 | |
| options create smaller files for workflows that need them. | |
| ### Why are the focus controls useful? | |
| They move the square crop across a non-square source so you can keep the intended face centered | |
| instead of accepting an automatic center crop. | |
| ### Can I use the output outside LiveFaceSwap AI? | |
| Yes. The output is a standard RGB PNG, so it can be used in other authorized portrait workflows | |
| that accept square reference images. | |
| ## Project and safety | |
| - [LiveFaceSwap AI official website](https://livefaceswap.ai/?utm_source=huggingface&utm_medium=referral&utm_campaign=reference_prep) | |
| - [Canonical source repository](https://github.com/LiveFaceSwapAI/livefaceswap-reference-prep) | |
| - [MIT license](https://github.com/LiveFaceSwapAI/livefaceswap-reference-prep/blob/main/LICENSE) | |
| Only process images you own or have permission to use. Do not use portrait references to | |
| impersonate, deceive, defraud, harass, or violate another person's rights. Disclose AI-altered | |
| media when the context requires it. | |