Initial commit

This commit is contained in:
2026-06-07 08:54:31 +02:00
commit 6a6da2d066
3 changed files with 44 additions and 0 deletions

1
.gitignore vendored Normal file
View File

@@ -0,0 +1 @@
venv/

24
README.md Normal file
View File

@@ -0,0 +1,24 @@
# Text to voice interface
## Overview
This project aims to provide text to voice with voice cloning ability. It is using chatterbox as backend.
## Origin
This project started as a [vibe-coded](https://en.wikipedia.org/wiki/Vibe_coding) [experiment](https://gitea.efforting.tech/mikael-lovqvists-claude-agent/claude-voice-experiment) but this version is somewhat more hands on.
## Setup
### Setup [venv](https://docs.python.org/3/library/venv.html) for [python](https://www.python.org/)
Run [`setup-venv.sh`](./setup-venv.sh).
> [!NOTE]
> The default location is a directory called `venv` that is created next to the script, but you can override it by using the environment variable `PYTHON_ENV` to point to a different location.
>
> ```console
> PYTHON_ENV='/some/path' ./setup-venv.s
> ```

19
setup-venv.sh Executable file
View File

@@ -0,0 +1,19 @@
#!/usr/bin/env bash
# Creates a venv in ./venv and installs Python deps for Chatterbox
set -euo pipefail
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
VENV="${PYTHON_ENV:-${SCRIPT_DIR}/venv}"
if [ ! -d "${VENV}" ]; then
echo "==> creating venv at ${VENV}"
python3 -m venv "${VENV}"
fi
echo "==> installing Python dependencies"
"${VENV}/bin/pip" install --upgrade pip --quiet
"${VENV}/bin/pip" install chatterbox-tts
echo ""
echo "==> venv ready at ${VENV}"