VoiceTerm
Voice-first terminal overlay for Codex and Claude. Local Whisper speech-to-text runs on your machine by default, with PTY passthrough and a customizable HUD.
Primary support: Codex and Claude Code.
Install
pipx install voiceterm
# or
python3 -m pip install --user voiceterm
Then run:
voiceterm
Authenticate your backend once if needed:
voiceterm --login --codex
voiceterm --login --claude
What This Package Does
The PyPI package installs the voiceterm launcher.
On first run, it bootstraps the native VoiceTerm binary into:
~/.local/share/voiceterm/native/bin/voiceterm(default)
By default it downloads a prebuilt release binary from the matching GitHub
release tag (v<package-version>), verifies the SHA256 checksum, and installs
it locally.
Default mode: VOICETERM_BOOTSTRAP_MODE=binary-only
Runtime Requirements
- Internet access to GitHub Releases (or a configured mirror)
- macOS or Linux (Windows via WSL2)
Source-build fallback requirements (only when enabled):
git- Rust toolchain (
cargo,rustc)
Optional Environment Overrides
VOICETERM_NATIVE_BIN=/absolute/path/to/voiceterm- Use an already-installed native binary and skip bootstrap.
VOICETERM_PY_NATIVE_ROOT=/custom/root- Change where the bootstrap binary is installed.
VOICETERM_BOOTSTRAP_MODE=binary-only|binary-then-source|source-only- Choose bootstrap strategy.
VOICETERM_RELEASE_OWNER_REPO=jguida941/voiceterm- Override GitHub owner/repo used for release binary downloads.
VOICETERM_RELEASE_BASE_URL=https://github.com/jguida941/voiceterm/releases/download- Override release download base URL (for mirror/proxy setups).
VOICETERM_REPO_URL=https://github.com/jguida941/voiceterm- Use a different source repository URL (source-bootstrap modes only).
VOICETERM_REPO_REF=vX.Y.Z- Override release tag for binary mode or git ref for source-bootstrap modes.
Documentation
- Main repository: https://github.com/jguida941/voiceterm
- Install guide: https://github.com/jguida941/voiceterm/blob/master/guides/INSTALL.md
- Usage guide: https://github.com/jguida941/voiceterm/blob/master/guides/USAGE.md
- CLI flags: https://github.com/jguida941/voiceterm/blob/master/guides/CLI_FLAGS.md
- Troubleshooting: https://github.com/jguida941/voiceterm/blob/master/guides/TROUBLESHOOTING.md
1 maintainer
Metadata
1 maintainer
Release files for voiceterm 1.2.6
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| voiceterm-1.2.6.tar.gz | 9.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| voiceterm-1.2.6-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 20.4 kB
Release files / voiceterm-1.2.6.tar.gz
| Download URL | voiceterm-1.2.6.tar.gz |
|---|---|
| Size | 9.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
777e40c3cd8192f45c017f72898a1ea5fa38ae6bffeff64274bfc9a9c67219c3
|
|
BLAKE2b-256 checksum How to use checksums |
b2ae59d1328270a5790b9567ac8867c09c286e969a4a105f41414cbd59d0b386
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.15
|
Release files / voiceterm-1.2.6-py3-none-any.whl
| Download URL | voiceterm-1.2.6-py3-none-any.whl |
|---|---|
| Size | 11.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
54dc0e66a356976c8bcc8479af59f56b670f124be535bf05313831625d7e6fb3
|
|
BLAKE2b-256 checksum How to use checksums |
73e66ce0da6a2839abb2de8548933034fbeb641abe345d3adbf854b7ce97b201
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.15
|
