RepoPilot

jamiepine / voicebox

Search jamiepine/voicebox

GitHub

Get started

Taken from the repository's own files on 24 Oct 2026. RepoPilot has not run these commands.

Prerequisites

Commands

package.json
TaskRunWhat it runs
devbun run devbun run setup:dev && cd tauri && bun run tauri dev
buildbun run build./scripts/build-server.sh && cd tauri && bun run tauri build
lintbun run lintbiome lint .
typecheckbun run typecheckbunx tsc -p app/tsconfig.json --noEmit && cd web && bunx tsc --noEmit
checkbun run checkbiome check .

Install and use

README.md
git clone https://github.com/jamiepine/voicebox.git
cd voicebox

just setup   # creates Python venv, installs all deps
just dev     # starts backend + desktop app

Install just: brew install just or cargo install just. Run just --list to see all commands.

Prerequisites: Bun, Rust, Python 3.12, Tauri Prerequisites, and Xcode on macOS.

The repo ships a pre-wired .mcp.json at the root — running Claude Code inside this checkout picks up the Voicebox MCP tools automatically once the dev app is running.

Open README.md

Developing

CONTRIBUTING.md

Development Setup

Install just (brew install just, cargo install just, or winget install Casey.Just), then:

git clone https://github.com/YOUR_USERNAME/voicebox.git
cd voicebox

just setup   # creates venv, installs Python + JS deps
just dev     # starts backend + desktop app

just setup handles everything automatically, including:

  • Creating a Python virtual environment pinned to 3.12 (recreating it if an existing venv is on the wrong version)
  • Installing Python dependencies (with CUDA PyTorch on Windows if an NVIDIA GPU is detected)
  • Installing MLX dependencies on Apple Silicon
  • Installing JavaScript dependencies

just dev starts the backend and desktop app together. If a backend is already running (e.g. from just dev-backend in another terminal), it detects it and only starts the frontend.

Other useful commands:

just dev-web       # backend + web app (no Tauri/Rust build)
just dev-backend   # backend only
just dev-frontend  # Tauri app only (backend must be running)
just kill          # stop all dev processes
just clean-all     # nuke everything and start fresh
just --list        # see all available commands

Note: In dev mode, the app connects to a manually-started Python server. The bundled server binary is only used in production builds.

Windows Notes

The justfile works natively on Windows via PowerShell. No WSL or Git Bash required. On Windows with an NVIDIA GPU, just setup automatically installs CUDA-enabled PyTorch for GPU acceleration. Python 3.12 is located via the py -3.12 launcher; install it with winget install -e --id Python.Python.3.12 if it's missing.

Read the rest of CONTRIBUTING.md