voxtype-install

# voxtype Install Guide voxtype is a standalone PyPI package for fully on-device voice dictation on macOS. It types transcribed speech into whatever app has focus. No cloud, no accounts, no audio leaving the machine. ## Install One command; it picks the best engine for the machine automatically (Apple-GPU `parakeet-mlx` on Apple Silicon, CPU `parakeet` elsewhere): ```bash uv tool install voxtype ``` If the user doesn't have `uv`, either install it first (`curl -LsSf https://astral.sh/uv/install.sh | sh`) or use `pipx install voxtype`. Note: voxtype only works on macOS (it types via macOS accessibility APIs). Tell the user this up front if they are on Linux/Windows. ## Configure Run the interactive wizard — it asks a handful of explained questions (engine, activation mode, hotkey, ...) and writes `~/.config/voxtype/config.toml`: ```bash voxtype setup ``` This must run in the user's own terminal (it is interactive); do not run it through an agent shell. Alternative for hand-editors: `voxtype init` writes a fully commented sample config instead. ### Editing the config directly All settings live in `~/.config/voxtype/config.toml` — every key is optional and the file `voxtype init` writes is fully commented. You (the agent) can open and edit this file to help the user tune specific options; common ones: - `engine` — `parakeet-mlx` (Apple GPU), `parakeet` (CPU), or `moonshine`. - `mode` — `toggle` (hotkey), `wake` (wake word), or `vad` (always on). - `segmentation` — `...