narrator-david-attenburo/README.md

62 lines
1.7 KiB
Markdown

# David Attenborough narrates your life.
https://twitter.com/charliebholtz/status/1724815159590293764
## Want to make your own AI app?
Check out [Replicate](https://replicate.com). We make it easy to run machine learning models with an API.
## Setup
Clone this repo, and setup and activate a virtualenv:
```bash
python3 -m pip install virtualenv
python3 -m virtualenv venv
source venv/bin/activate
```
Then, install the dependencies:
`pip install -r requirements.txt`
Make a [Replicate](https://replicate.com), [OpenAI](https://beta.openai.com/), and [ElevenLabs](https://elevenlabs.io) account and set your tokens:
```bash
export OPENAI_API_KEY=<token>
export ELEVENLABS_API_KEY=<eleven-token>
```
Make a new voice in Eleven and get the voice id of that voice using their [get voices](https://elevenlabs.io/docs/api-reference/voices) API, or by clicking the flask icon next to the voice in the VoiceLab tab.
```bash
export ELEVENLABS_VOICE_ID=<voice-id>
```
### Streaming
If you would like the speech to start quicker via a streaming manner set the environment variable to enable. The concession is that the audio snippet is not saved in the `/narration` directory.
```bash
export ELEVENLABS_STREAMING=true
```
### Script
Alternative to running the commands above individually, one can use the `setup.sh` script to facilitate getting the two required shell envs ready to rock by updating the environment variable values in `setup.sh` and executing the script.
_Note: may have to manually run `source source venv/bin/activate` afterwards depending on shell env._
## Run it!
In on terminal, run the webcam capture:
```bash
python capture.py
```
In another terminal, run the narrator:
```bash
python narrator.py
```