voxtype 0.1.0__tar.gz

voxtype-0.1.0/.gitignore

@@ -0,0 +1,195 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+Pipfile.lock
+
+# poetry
+poetry.lock
+
+# pdm
+.pdm.toml
+.pdm-python
+
+# PEP 582
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+.idea/
+
+# VS Code
+.vscode/
+
+# macOS
+.DS_Store
+
+# Windows
+Thumbs.db
+ehthumbs.db
+
+# Linux
+*~
+
+# Temporary files
+*.tmp
+*.bak
+*.swp
+*.swo
+
+# UV
+.uv/
+
+# Ruff
+.ruff_cache/
+
+# Local development
+local/
+scratch/
+
+# Claude Code settings and environment files
+settings.json
+hook-settings.json
+hooks/settings.json
+.env*
+node_modules/
+package-lock.json
+!node_ui/package-lock.json
+!docs-site/package-lock.json
+!plugins/dynamic-workflow/package-lock.json
+
+# Backup files
+*.backup*
+to-be-deleted.md
+reference/
+
+# Ignore config.json files at any level
+**/config.json
+*.flag
+
+# Local files
+issues/
+WORKLOG/
+
+jsonl-structure-summary.md

voxtype-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Prasad Chalasani
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

voxtype-0.1.0/PKG-INFO

@@ -0,0 +1,156 @@
+Metadata-Version: 2.4
+Name: voxtype
+Version: 0.1.0
+Summary: Local, streaming speech-to-text that types wherever your cursor is (macOS)
+Project-URL: Homepage, https://github.com/pchalasani/claude-code-tools
+Project-URL: Documentation, https://pchalasani.github.io/claude-code-tools/tools/voxtype/
+Author-email: Prasad Chalasani <pchalasani@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2025 Prasad Chalasani
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Keywords: dictation,macos,parakeet,speech-to-text,voice,whisper
+Classifier: Environment :: MacOS X
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
+Requires-Python: >=3.11
+Requires-Dist: numba>=0.61; sys_platform == 'darwin' and platform_machine == 'arm64'
+Requires-Dist: numpy>=1.26.0
+Requires-Dist: parakeet-mlx>=0.5.0; sys_platform == 'darwin' and platform_machine == 'arm64'
+Requires-Dist: pynput>=1.7.7
+Requires-Dist: questionary>=2.0.0
+Requires-Dist: sherpa-onnx-core<1.13,>=1.12.0
+Requires-Dist: sherpa-onnx<1.13,>=1.12.0
+Requires-Dist: sounddevice>=0.5.0
+Provides-Extra: mlx
+Provides-Extra: moonshine
+Requires-Dist: moonshine-voice>=0.0.69; extra == 'moonshine'
+Provides-Extra: parakeet
+Description-Content-Type: text/markdown
+
+# voxtype — local voice dictation that types where your cursor is
+
+`voxtype` turns speech into text in whatever app has focus — your editor,
+browser, terminal, or a coding agent's prompt box. Everything runs on your
+machine: no cloud, no accounts, no audio leaving your Mac.
+
+> **macOS only (Intel and Apple Silicon).** voxtype relies on macOS APIs
+> for typing (accessibility), hotkey suppression (the CGEvent tap), and its
+> overlay (AppKit). **It is not supported on Linux or Windows** — the toggle
+> hotkey can't be suppressed there (it leaks into your text), there is no
+> overlay, and it is untested. On Apple Silicon (M1 or later) it defaults to
+> the `parakeet-mlx` Apple-GPU engine; Intel Macs use the `parakeet` CPU
+> engine.
+
+## Install
+
+```bash
+uv tool install voxtype
+```
+
+That's it. The install includes the best engine for your machine — the
+Apple-GPU `parakeet-mlx` engine on Apple Silicon (best accuracy AND
+speed), the CPU `parakeet` engine everywhere else — and that engine is
+the runtime default too, so no flags are needed.
+
+Or run without installing: `uvx voxtype`. (No `uv`? `pipx install
+voxtype` works too.)
+
+## Why it's different
+
+- **One key to dictate.** Hit the toggle hotkey (default `Ctrl+;`), speak as
+  long as you like, hit it again — the whole take is transcribed with full
+  sentence context and typed in one go (a single edit to undo, in most
+  apps). No chopping at pauses, sub-second results.
+- **Or go hands-free.** Say "hey claude" (configurable, with alias
+  spellings) to start dictating; say "stop listening" or go quiet to
+  re-arm. The hotkey still works as an override.
+- **Spoken submit.** Say "go", "over", or "submit" as a standalone
+  utterance and voxtype presses Enter — dictate a prompt to a coding agent
+  and send it without touching the keyboard.
+- **Clean transcripts.** Standalone fillers (uh, um, ...) are stripped and
+  3+ word stutters collapse ("I I I think" becomes "I think") — on-device
+  regex, no LLM involved.
+- **Visible when it matters.** A floating waveform pill appears ONLY while
+  recording — red waves as you speak. Pill on screen = mic live; no pill =
+  not listening.
+- **Nothing is ever lost.** Dictated into the wrong window? A paste-again
+  hotkey re-types the last session's transcript at the cursor; optional
+  clipboard mirroring too. Escape cancels a recording outright.
+
+## Quick start
+
+1. Install (see above), then grant your terminal **Microphone**,
+   **Accessibility**, and **Input Monitoring** permissions
+   (System Settings → Privacy & Security) when prompted.
+
+2. Start dictating:
+
+   ```bash
+   voxtype --segmentation hold
+   ```
+
+   Press `Ctrl+;`, speak (watch the waveform pill), press `Ctrl+;` again —
+   the whole take types at your cursor. `Esc` cancels a take.
+
+3. Make it yours: run `voxtype setup` for an interactive walkthrough — it
+   asks a handful of explained questions (engine, mode, hotkey, ...) and
+   writes your `~/.config/voxtype/config.toml`. (Prefer editing by hand?
+   `voxtype init` drops a fully commented sample instead.) After that,
+   plain `voxtype` starts with your settings.
+
+## Hotkey & voice vocabulary
+
+| Action | Default | Configurable as |
+|--------|---------|-----------------|
+| Toggle recording | `Ctrl+;` | `hotkey` |
+| Cancel recording (discard) | `Esc` (only while recording) | `cancel_hotkey` |
+| Re-type last transcript | off | `paste_hotkey` |
+| Submit (press Enter) | say "go" / "over" / "submit" | `submit_phrases` |
+| Stop dictating | say "stop listening" | `stop_phrase` |
+
+Not sure how to spell a chord? Run `voxtype hotkey`, press the combo you
+want, and it prints the exact line to put in your config
+(e.g. `hotkey = "<ctrl>+;"`).
+
+## Engines
+
+| Engine | Availability | Notes |
+|--------|--------------|-------|
+| `parakeet-mlx` | included (default on Apple Silicon) | Parakeet-TDT 0.6b v3 on the Apple GPU via MLX: fp16 accuracy at ~40x realtime — best accuracy AND speed |
+| `parakeet` | included (default elsewhere) | Parakeet-TDT 0.6b v3 on CPU via sherpa-onnx (~490 MB download) |
+| `moonshine` | opt-in: `voxtype[moonshine]` | Streaming Moonshine models, smallest footprint (no Intel-macOS build) |
+
+## Documentation
+
+Full reference — every config key with its default, the engine comparison,
+and all CLI flags:
+<https://pchalasani.github.io/claude-code-tools/tools/voxtype/>
+
+## History
+
+voxtype previously shipped as `voice-type` inside
+[claude-code-tools](https://github.com/pchalasani/claude-code-tools). It
+still reads a legacy `~/.config/voice-type/config.toml` and reuses the old
+`~/.cache/voice-type` model cache, so upgrading is seamless.
+
+MIT license.

voxtype-0.1.0/README.md

@@ -0,0 +1,107 @@
+# voxtype — local voice dictation that types where your cursor is
+
+`voxtype` turns speech into text in whatever app has focus — your editor,
+browser, terminal, or a coding agent's prompt box. Everything runs on your
+machine: no cloud, no accounts, no audio leaving your Mac.
+
+> **macOS only (Intel and Apple Silicon).** voxtype relies on macOS APIs
+> for typing (accessibility), hotkey suppression (the CGEvent tap), and its
+> overlay (AppKit). **It is not supported on Linux or Windows** — the toggle
+> hotkey can't be suppressed there (it leaks into your text), there is no
+> overlay, and it is untested. On Apple Silicon (M1 or later) it defaults to
+> the `parakeet-mlx` Apple-GPU engine; Intel Macs use the `parakeet` CPU
+> engine.
+
+## Install
+
+```bash
+uv tool install voxtype
+```
+
+That's it. The install includes the best engine for your machine — the
+Apple-GPU `parakeet-mlx` engine on Apple Silicon (best accuracy AND
+speed), the CPU `parakeet` engine everywhere else — and that engine is
+the runtime default too, so no flags are needed.
+
+Or run without installing: `uvx voxtype`. (No `uv`? `pipx install
+voxtype` works too.)
+
+## Why it's different
+
+- **One key to dictate.** Hit the toggle hotkey (default `Ctrl+;`), speak as
+  long as you like, hit it again — the whole take is transcribed with full
+  sentence context and typed in one go (a single edit to undo, in most
+  apps). No chopping at pauses, sub-second results.
+- **Or go hands-free.** Say "hey claude" (configurable, with alias
+  spellings) to start dictating; say "stop listening" or go quiet to
+  re-arm. The hotkey still works as an override.
+- **Spoken submit.** Say "go", "over", or "submit" as a standalone
+  utterance and voxtype presses Enter — dictate a prompt to a coding agent
+  and send it without touching the keyboard.
+- **Clean transcripts.** Standalone fillers (uh, um, ...) are stripped and
+  3+ word stutters collapse ("I I I think" becomes "I think") — on-device
+  regex, no LLM involved.
+- **Visible when it matters.** A floating waveform pill appears ONLY while
+  recording — red waves as you speak. Pill on screen = mic live; no pill =
+  not listening.
+- **Nothing is ever lost.** Dictated into the wrong window? A paste-again
+  hotkey re-types the last session's transcript at the cursor; optional
+  clipboard mirroring too. Escape cancels a recording outright.
+
+## Quick start
+
+1. Install (see above), then grant your terminal **Microphone**,
+   **Accessibility**, and **Input Monitoring** permissions
+   (System Settings → Privacy & Security) when prompted.
+
+2. Start dictating:
+
+   ```bash
+   voxtype --segmentation hold
+   ```
+
+   Press `Ctrl+;`, speak (watch the waveform pill), press `Ctrl+;` again —
+   the whole take types at your cursor. `Esc` cancels a take.
+
+3. Make it yours: run `voxtype setup` for an interactive walkthrough — it
+   asks a handful of explained questions (engine, mode, hotkey, ...) and
+   writes your `~/.config/voxtype/config.toml`. (Prefer editing by hand?
+   `voxtype init` drops a fully commented sample instead.) After that,
+   plain `voxtype` starts with your settings.
+
+## Hotkey & voice vocabulary
+
+| Action | Default | Configurable as |
+|--------|---------|-----------------|
+| Toggle recording | `Ctrl+;` | `hotkey` |
+| Cancel recording (discard) | `Esc` (only while recording) | `cancel_hotkey` |
+| Re-type last transcript | off | `paste_hotkey` |
+| Submit (press Enter) | say "go" / "over" / "submit" | `submit_phrases` |
+| Stop dictating | say "stop listening" | `stop_phrase` |
+
+Not sure how to spell a chord? Run `voxtype hotkey`, press the combo you
+want, and it prints the exact line to put in your config
+(e.g. `hotkey = "<ctrl>+;"`).
+
+## Engines
+
+| Engine | Availability | Notes |
+|--------|--------------|-------|
+| `parakeet-mlx` | included (default on Apple Silicon) | Parakeet-TDT 0.6b v3 on the Apple GPU via MLX: fp16 accuracy at ~40x realtime — best accuracy AND speed |
+| `parakeet` | included (default elsewhere) | Parakeet-TDT 0.6b v3 on CPU via sherpa-onnx (~490 MB download) |
+| `moonshine` | opt-in: `voxtype[moonshine]` | Streaming Moonshine models, smallest footprint (no Intel-macOS build) |
+
+## Documentation
+
+Full reference — every config key with its default, the engine comparison,
+and all CLI flags:
+<https://pchalasani.github.io/claude-code-tools/tools/voxtype/>
+
+## History
+
+voxtype previously shipped as `voice-type` inside
+[claude-code-tools](https://github.com/pchalasani/claude-code-tools). It
+still reads a legacy `~/.config/voice-type/config.toml` and reuses the old
+`~/.cache/voice-type` model cache, so upgrading is seamless.
+
+MIT license.

voxtype-0.1.0/pyproject.toml

@@ -0,0 +1,64 @@
+[project]
+name = "voxtype"
+version = "0.1.0"
+description = "Local, streaming speech-to-text that types wherever your cursor is (macOS)"
+readme = "README.md"
+license = { file = "LICENSE" }
+authors = [{ name = "Prasad Chalasani", email = "pchalasani@gmail.com" }]
+requires-python = ">=3.11"
+keywords = ["speech-to-text", "dictation", "voice", "whisper", "parakeet", "macos"]
+classifiers = [
+    "Environment :: MacOS X",
+    "Operating System :: MacOS",
+    "Programming Language :: Python :: 3",
+    "Topic :: Multimedia :: Sound/Audio :: Speech",
+]
+# A plain `uv tool install voxtype` gets the best engine for the
+# machine: parakeet-mlx (Apple GPU) on Apple Silicon, parakeet CPU
+# (sherpa-onnx) everywhere else. Markers gate the arm64-only MLX stack.
+dependencies = [
+    "pynput>=1.7.7",
+    # The `voxtype setup` onboarding wizard uses questionary; it is the
+    # advertised first-run path, so it ships in the base install (not an
+    # extra) — otherwise `voxtype setup` would fail on a clean install.
+    "questionary>=2.0.0",
+    # Apple-GPU engine (Apple Silicon Macs only; wheels are arm64).
+    "parakeet-mlx>=0.5.0; sys_platform == 'darwin' and platform_machine == 'arm64'",
+    # Resolver guard: without it uv can backtrack through parakeet-mlx
+    # -> librosa -> numba to a 2021 llvmlite that cannot build on
+    # modern Python ("Cannot install on Python version 3.13...").
+    "numba>=0.61; sys_platform == 'darwin' and platform_machine == 'arm64'",
+    # sherpa-onnx: the parakeet CPU engine AND the Silero VAD used by
+    # parakeet-mlx segmentation.
+    # 1.13.x wheels are missing their bundled onnxruntime dylib on
+    # macOS arm64 (dlopen fails); 1.12.x splits the native libs into
+    # sherpa-onnx-core, which some resolvers miss (uv caches wheel
+    # metadata without it) — declare it explicitly.
+    "sherpa-onnx>=1.12.0,<1.13",
+    "sherpa-onnx-core>=1.12.0,<1.13",
+    "sounddevice>=0.5.0",
+    "numpy>=1.26.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/pchalasani/claude-code-tools"
+Documentation = "https://pchalasani.github.io/claude-code-tools/tools/voxtype/"
+
+[project.optional-dependencies]
+# The moonshine streaming engine, for those who want it (no
+# Intel-macOS wheels exist, hence opt-in).
+moonshine = ["moonshine-voice>=0.0.69"]
+# Back-compat aliases from when the engines were opt-in extras; both
+# engines now ship in the base install (mlx marker-gated to arm64).
+parakeet = []
+mlx = []
+
+[project.scripts]
+voxtype = "voxtype.cli:main"
+
+[build-system]
+requires = ["hatchling==1.28.0"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/voxtype"]

voxtype-0.1.0/src/voxtype/__init__.py

@@ -0,0 +1,7 @@
+"""voxtype: local, streaming speech-to-text that types where your cursor is.
+
+Fully on-device transcription — NVIDIA Parakeet-TDT on the Apple GPU
+(MLX) or CPU (sherpa-onnx), or Moonshine streaming models — with voice
+activity detection, a configurable global hotkey, and an optional wake
+word (e.g. "claude").
+"""