validation and install uses python commands

This commit is contained in:
dhananjaypai08
2026-10-03 09:24:23 +00:00
committed by jamiepine
parent a14f0ce3d9
commit 41db2ab446
3 changed files with 38 additions and 33 deletions
+5 -2
View File
@@ -35,7 +35,8 @@ Ensure you have these installed:
<Card title="Python 3.12" icon={<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round"><path d="M12 2L2 7l10 5 10-5-10-5z"/><path d="M2 17l10 5 10-5"/><path d="M2 12l10 5 10-5"/></svg>}>
[Download Python](https://python.org)
```bash
python3.12 --version # Should be 3.12.x
python3.12 --version # macOS/Linux — should be 3.12.x
py -3.12 --version # Windows
```
Voicebox pins its venv to 3.12 to match CI, because some dependencies have no 3.13 release yet. On Debian/Ubuntu also install `python3.12-venv`.
</Card>
@@ -216,7 +217,9 @@ This installs dependencies for:
cd backend
# Create virtual environment (use Python 3.12 — see Prerequisites)
python3.12 -m venv venv
python3.12 -m venv venv # macOS/Linux
# or
py -3.12 -m venv venv # Windows
# Activate virtual environment
source venv/bin/activate # macOS/Linux
@@ -295,7 +295,8 @@ This is expected behavior. The first generation downloads the selected TTS engin
Ensure Python 3.12:
```bash
python3.12 --version
python3.12 --version # macOS/Linux
py -3.12 --version # Windows
```
Voicebox pins its venv to Python 3.12 because some dependencies have no 3.13
@@ -303,8 +304,10 @@ This is expected behavior. The first generation downloads the selected TTS engin
so re-running it is usually the fix.
If `just setup` can't find a usable 3.12, install one: `uv python install 3.12`
works anywhere, or use `brew install [email protected]` on macOS and `sudo apt install
python3.12 python3.12-venv` on Debian/Ubuntu.
works anywhere; `brew install [email protected]` on macOS; `sudo apt install
python3.12 python3.12-venv` on Debian/Ubuntu; or on Windows install from
[python.org](https://python.org) / `winget install -e --id Python.Python.3.12`
and use the `py -3.12` launcher.
</Accordion>
<Accordion title="Virtual Environment">