# FaceStream | Swap Your Face In Real-time

**URL:** <https://onehack.st/t/facestream-swap-your-face-in-real-time/301696>\
**Category:** Tools & Scripts\
**Tags:** tools, programming, freebies, ai, streaming\
**Created:** [March 5, 2025, 8:09pm UTC](https://onehack.st/t/facestream-swap-your-face-in-real-time/301696 "2025-03-05T20:09:11Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![Aina](https://onehack.st/user_avatar/onehack.st/aina/32/167469_2.png) [@Aina](https://onehack.st/u/Aina)\
**Post date:** [March 5, 2025, 8:09pm UTC](https://onehack.st/t/facestream-swap-your-face-in-real-time/301696/1 "2025-03-05T20:09:11Z")

</div>

# FaceStream

This is a web app that let’s you swap your face in real-time without having a powerful machine. You can try it out live [here](https://facestream.phileisen.com/).

See the gif below for a demo:

[![Demo](https://github.com/philipp-eisen/facestream/raw/main/assets/demo.gif)](https://facestream.phileisen.com/)

## Motivation

I discovered the [Deep Live Cam](https://github.com/hacksider/Deep-Live-Cam) project and tried to run it on my M1 MacBook, but only got 0.5 FPS. So I wanted to explore how fast and at what latency you could get this to run on a remote server via WebRTC.

## How to run this yourself

### Prerequisites

To run this yourself you wil need:

- [uv](https://docs.astral.sh/uv/)
- A [modal](https://modal.com/) account as well configured credentials

Then you can run the following command to start the server:

```auto
uv run modal serve facestream.main

```

Or this command to deploy it:

```auto
uv run modal deploy facestream.main

```

### Optional: TURN Server for Cellular Networks

On most cellular networks you need a TURN server for WebRTC to work. You can create a TURN app on [Cloudflare](https://developers.cloudflare.com/calls/turn/). To use those with this app you need to:

1. Create a secret called `facestream` in modal with the following values:

```auto
TURN_TOKEN_ID=your-turn-token-id
TURN_API_TOKEN=your-turn-api-token

```

1. Comment out the following line in [src/facestream/main.py](https://github.com/philipp-eisen/facestream/blob/main/src/facestream/main.py):

```auto
...
secrets=[
    modal.Secret.from_name(
        "facestream",
        required_keys=[SECRET_KEY_TURN_TOKEN_ID, SECRET_KEY_TURN_API_TOKEN],
    )
]
...

```

## Credits

- This project was inspired by and uses the model of [Deep Live Cam](https://github.com/hacksider/Deep-Live-Cam). Go check out their project. They have some extra features that I didn’t implement here. Note that the model used in that project (and therefore also this one) is only for non-commercial use.
- [Modal](https://modal.com/) made this easy to build and deploy. They are generously providing free credits to host the live demo.

## GitHub:

> **[GitHub - philipp-eisen/facestream: Swap your face in real-time](https://github.com/philipp-eisen/facestream)**
>
> Swap your face in real-time