python-voiceio 0.2.3__tar.gz → 0.2.4__tar.gz

{python_voiceio-0.2.3/python_voiceio.egg-info → python_voiceio-0.2.4}/PKG-INFO

@@ -1,11 +1,13 @@
 Metadata-Version: 2.4
 Name: python-voiceio
-Version: 0.2.3
+Version: 0.2.4
 Summary: Speak → text, locally, instantly.
 Author: Hugo Montenegro
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/Hugo0/voiceio
+Project-URL: Repository, https://github.com/Hugo0/voiceio
 Project-URL: Issues, https://github.com/Hugo0/voiceio/issues
+Project-URL: Changelog, https://github.com/Hugo0/voiceio/releases
 Keywords: voice,speech-to-text,whisper,linux,dictation,wayland,ibus
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: X11 Applications
@@ -41,15 +43,6 @@ Dynamic: license-file
 
 Speak → text, locally, instantly.
 
-<!-- demo video -->
-<p align="center">
-  <a href="https://www.tella.tv/video/YOUR_VIDEO_ID">
-    <img src="https://github.com/Hugo0/voiceio/raw/main/assets/demo-thumbnail.png" alt="voiceio demo" width="600">
-  </a>
-  <br>
-  <em>Click to watch the demo</em>
-</p>
-
 ## Quick start
 
 ```bash
@@ -98,7 +91,7 @@ voiceio setup
 ```
 </details>
 
-> You can also install with `uv tool install voiceio` or `pip install voiceio`.
+> You can also install with `uv tool install python-voiceio` or `pip install python-voiceio`.
 
 ## How it works
 
@@ -143,6 +136,7 @@ voiceio setup            Interactive setup wizard
 voiceio doctor           Health check (--fix to auto-repair)
 voiceio test             Test microphone + live transcription
 voiceio toggle           Toggle recording on a running daemon
+voiceio update           Update to latest version
 voiceio service install  Autostart on login via systemd
 voiceio logs             View recent logs
 voiceio uninstall        Remove all system integrations
@@ -194,28 +188,15 @@ voiceio uninstall        # removes service, IBus, shortcuts, symlinks
 pipx uninstall python-voiceio   # removes the package
 ```
 
-## TODO
-
-**Launch**
-- [ ] Publish to PyPI
-- [ ] Record demo video + thumbnail
-- [ ] Test clean install on a fresh VM/container
-- [ ] GitHub repo: description, topics, social preview image
-- [ ] Bump version to 0.2.0
-
-**Code quality**
-- [ ] IBus activation on non-GNOME desktops (KDE, Sway, Hyprland), currently GNOME-only via gsettings
-- [ ] `voiceio doctor --json` for machine-readable output
-- [ ] Shell completions (`voiceio completion bash/zsh/fish`)
-- [ ] Refactor wizard.py (882 lines) into smaller, testable modules
-- [ ] Socket protocol versioning (e.g. `v1:preedit:text`)
-- [ ] Configurable log file path
-
 ## Wishlist
 
-Contributions welcome! Open an issue to discuss before starting.
+Contributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md). Open an issue to discuss before starting.
 
 **High impact**
+- [ ] **macOS support**: test and polish pynput hotkey + typer backends
+- [ ] **Silence filtering**: VAD-based trimming to prevent Whisper hallucinations on silence
+- [ ] **distil-whisper models**: better speed/accuracy tradeoffs
+- [ ] **IBus on non-GNOME desktops**: KDE, Sway, Hyprland activation (currently GNOME-only via gsettings)
 - [ ] **Text-to-speech (voice output)**: select text, press a hotkey, hear it spoken aloud. Completes the "io" in voiceio. Use a local TTS engine (Piper, Coqui, espeak-ng), same philosophy: no cloud, no API keys
 - [ ] **Wake word**: "Hey voiceio" hands-free activation (no hotkey needed). Use a small always-on keyword model (e.g. openWakeWord, Porcupine)
 - [ ] **Custom vocabulary / hot words**: user-defined word list for names, jargon, technical terms that Whisper gets wrong. Boost via `initial_prompt` or fine-tuned logit bias

{python_voiceio-0.2.3 → python_voiceio-0.2.4}/README.md

@@ -7,15 +7,6 @@
 
 Speak → text, locally, instantly.
 
-<!-- demo video -->
-<p align="center">
-  <a href="https://www.tella.tv/video/YOUR_VIDEO_ID">
-    <img src="https://github.com/Hugo0/voiceio/raw/main/assets/demo-thumbnail.png" alt="voiceio demo" width="600">
-  </a>
-  <br>
-  <em>Click to watch the demo</em>
-</p>
-
 ## Quick start
 
 ```bash
@@ -64,7 +55,7 @@ voiceio setup
 ```
 </details>
 
-> You can also install with `uv tool install voiceio` or `pip install voiceio`.
+> You can also install with `uv tool install python-voiceio` or `pip install python-voiceio`.
 
 ## How it works
 
@@ -109,6 +100,7 @@ voiceio setup            Interactive setup wizard
 voiceio doctor           Health check (--fix to auto-repair)
 voiceio test             Test microphone + live transcription
 voiceio toggle           Toggle recording on a running daemon
+voiceio update           Update to latest version
 voiceio service install  Autostart on login via systemd
 voiceio logs             View recent logs
 voiceio uninstall        Remove all system integrations
@@ -160,28 +152,15 @@ voiceio uninstall        # removes service, IBus, shortcuts, symlinks
 pipx uninstall python-voiceio   # removes the package
 ```
 
-## TODO
-
-**Launch**
-- [ ] Publish to PyPI
-- [ ] Record demo video + thumbnail
-- [ ] Test clean install on a fresh VM/container
-- [ ] GitHub repo: description, topics, social preview image
-- [ ] Bump version to 0.2.0
-
-**Code quality**
-- [ ] IBus activation on non-GNOME desktops (KDE, Sway, Hyprland), currently GNOME-only via gsettings
-- [ ] `voiceio doctor --json` for machine-readable output
-- [ ] Shell completions (`voiceio completion bash/zsh/fish`)
-- [ ] Refactor wizard.py (882 lines) into smaller, testable modules
-- [ ] Socket protocol versioning (e.g. `v1:preedit:text`)
-- [ ] Configurable log file path
-
 ## Wishlist
 
-Contributions welcome! Open an issue to discuss before starting.
+Contributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md). Open an issue to discuss before starting.
 
 **High impact**
+- [ ] **macOS support**: test and polish pynput hotkey + typer backends
+- [ ] **Silence filtering**: VAD-based trimming to prevent Whisper hallucinations on silence
+- [ ] **distil-whisper models**: better speed/accuracy tradeoffs
+- [ ] **IBus on non-GNOME desktops**: KDE, Sway, Hyprland activation (currently GNOME-only via gsettings)
 - [ ] **Text-to-speech (voice output)**: select text, press a hotkey, hear it spoken aloud. Completes the "io" in voiceio. Use a local TTS engine (Piper, Coqui, espeak-ng), same philosophy: no cloud, no API keys
 - [ ] **Wake word**: "Hey voiceio" hands-free activation (no hotkey needed). Use a small always-on keyword model (e.g. openWakeWord, Porcupine)
 - [ ] **Custom vocabulary / hot words**: user-defined word list for names, jargon, technical terms that Whisper gets wrong. Boost via `initial_prompt` or fine-tuned logit bias

{python_voiceio-0.2.3 → python_voiceio-0.2.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-voiceio"
-version = "0.2.3"
+version = "0.2.4"
 description = "Speak → text, locally, instantly."
 readme = "README.md"
 license = "MIT"
@@ -34,7 +34,9 @@ dev = ["pytest>=7.0", "pytest-mock"]
 
 [project.urls]
 Homepage = "https://github.com/Hugo0/voiceio"
+Repository = "https://github.com/Hugo0/voiceio"
 Issues = "https://github.com/Hugo0/voiceio/issues"
+Changelog = "https://github.com/Hugo0/voiceio/releases"
 
 [project.scripts]
 voiceio = "voiceio.cli:main"

{python_voiceio-0.2.3 → python_voiceio-0.2.4/python_voiceio.egg-info}/PKG-INFO

@@ -1,11 +1,13 @@
 Metadata-Version: 2.4
 Name: python-voiceio
-Version: 0.2.3
+Version: 0.2.4
 Summary: Speak → text, locally, instantly.
 Author: Hugo Montenegro
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/Hugo0/voiceio
+Project-URL: Repository, https://github.com/Hugo0/voiceio
 Project-URL: Issues, https://github.com/Hugo0/voiceio/issues
+Project-URL: Changelog, https://github.com/Hugo0/voiceio/releases
 Keywords: voice,speech-to-text,whisper,linux,dictation,wayland,ibus
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: X11 Applications
@@ -41,15 +43,6 @@ Dynamic: license-file
 
 Speak → text, locally, instantly.
 
-<!-- demo video -->
-<p align="center">
-  <a href="https://www.tella.tv/video/YOUR_VIDEO_ID">
-    <img src="https://github.com/Hugo0/voiceio/raw/main/assets/demo-thumbnail.png" alt="voiceio demo" width="600">
-  </a>
-  <br>
-  <em>Click to watch the demo</em>
-</p>
-
 ## Quick start
 
 ```bash
@@ -98,7 +91,7 @@ voiceio setup
 ```
 </details>
 
-> You can also install with `uv tool install voiceio` or `pip install voiceio`.
+> You can also install with `uv tool install python-voiceio` or `pip install python-voiceio`.
 
 ## How it works
 
@@ -143,6 +136,7 @@ voiceio setup            Interactive setup wizard
 voiceio doctor           Health check (--fix to auto-repair)
 voiceio test             Test microphone + live transcription
 voiceio toggle           Toggle recording on a running daemon
+voiceio update           Update to latest version
 voiceio service install  Autostart on login via systemd
 voiceio logs             View recent logs
 voiceio uninstall        Remove all system integrations
@@ -194,28 +188,15 @@ voiceio uninstall        # removes service, IBus, shortcuts, symlinks
 pipx uninstall python-voiceio   # removes the package
 ```
 
-## TODO
-
-**Launch**
-- [ ] Publish to PyPI
-- [ ] Record demo video + thumbnail
-- [ ] Test clean install on a fresh VM/container
-- [ ] GitHub repo: description, topics, social preview image
-- [ ] Bump version to 0.2.0
-
-**Code quality**
-- [ ] IBus activation on non-GNOME desktops (KDE, Sway, Hyprland), currently GNOME-only via gsettings
-- [ ] `voiceio doctor --json` for machine-readable output
-- [ ] Shell completions (`voiceio completion bash/zsh/fish`)
-- [ ] Refactor wizard.py (882 lines) into smaller, testable modules
-- [ ] Socket protocol versioning (e.g. `v1:preedit:text`)
-- [ ] Configurable log file path
-
 ## Wishlist
 
-Contributions welcome! Open an issue to discuss before starting.
+Contributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md). Open an issue to discuss before starting.
 
 **High impact**
+- [ ] **macOS support**: test and polish pynput hotkey + typer backends
+- [ ] **Silence filtering**: VAD-based trimming to prevent Whisper hallucinations on silence
+- [ ] **distil-whisper models**: better speed/accuracy tradeoffs
+- [ ] **IBus on non-GNOME desktops**: KDE, Sway, Hyprland activation (currently GNOME-only via gsettings)
 - [ ] **Text-to-speech (voice output)**: select text, press a hotkey, hear it spoken aloud. Completes the "io" in voiceio. Use a local TTS engine (Piper, Coqui, espeak-ng), same philosophy: no cloud, no API keys
 - [ ] **Wake word**: "Hey voiceio" hands-free activation (no hotkey needed). Use a small always-on keyword model (e.g. openWakeWord, Porcupine)
 - [ ] **Custom vocabulary / hot words**: user-defined word list for names, jargon, technical terms that Whisper gets wrong. Boost via `initial_prompt` or fine-tuned logit bias

python_voiceio-0.2.4/voiceio/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.2.4"

{python_voiceio-0.2.3 → python_voiceio-0.2.4}/voiceio/app.py

@@ -18,7 +18,6 @@ from voiceio.recorder import AudioRecorder
 from voiceio.streaming import StreamingSession
 from voiceio.transcriber import Transcriber
 from voiceio.typers import chain as typer_chain
-from voiceio.typers.base import StreamingTyper
 log = logging.getLogger("voiceio")
 
 

{python_voiceio-0.2.3 → python_voiceio-0.2.4}/voiceio/cli.py

@@ -59,6 +59,9 @@ def main() -> None:
                            choices=["install", "uninstall", "start", "stop", "status"],
                            help="Action to perform (default: status)")
 
+    # ── voiceio update ──────────────────────────────────────────────────
+    sub.add_parser("update", help="Update voiceio to the latest version")
+
     # ── voiceio uninstall ──────────────────────────────────────────────
     sub.add_parser("uninstall", help="Remove all voiceio system integrations")
 
@@ -77,6 +80,8 @@ def main() -> None:
         _cmd_test()
     elif args.command == "service":
         _cmd_service(args)
+    elif args.command == "update":
+        _cmd_update()
     elif args.command == "uninstall":
         _cmd_uninstall()
     elif args.command == "logs":
@@ -283,6 +288,37 @@ def _cmd_service(args: argparse.Namespace) -> None:
             sys.exit(1)
 
 
+def _cmd_update() -> None:
+    """Update voiceio to the latest PyPI version."""
+    import subprocess
+    from voiceio import __version__
+    from voiceio.config import PYPI_NAME
+
+    is_pipx = "pipx" in sys.prefix
+    if is_pipx:
+        print(f"Current version: {__version__}")
+        print("Checking for updates...")
+        try:
+            result = subprocess.run(
+                ["pipx", "upgrade", PYPI_NAME],
+                capture_output=True, text=True, timeout=60,
+            )
+            print(result.stdout.strip())
+            if result.returncode != 0 and result.stderr.strip():
+                print(result.stderr.strip(), file=sys.stderr)
+                sys.exit(1)
+        except FileNotFoundError:
+            print("pipx not found. Update manually: pipx upgrade " + PYPI_NAME, file=sys.stderr)
+            sys.exit(1)
+        except subprocess.TimeoutExpired:
+            print("Update timed out.", file=sys.stderr)
+            sys.exit(1)
+    else:
+        print("Not a pipx install. Update manually:")
+        print(f"  pip install --upgrade {PYPI_NAME}")
+        sys.exit(1)
+
+
 def _cmd_uninstall() -> None:
     """Remove all voiceio system integrations."""
     import os

{python_voiceio-0.2.3 → python_voiceio-0.2.4}/voiceio/wizard.py

@@ -860,7 +860,7 @@ def run_wizard() -> None:
     from voiceio.config import LOG_PATH
     log_path = LOG_PATH
     start_hint = (
-        f"  voiceio is running and will start automatically on login."
+        "  voiceio is running and will start automatically on login."
         if autostart_idx == 0
         else f"  Start voiceio:\n    {CYAN}voiceio{RESET}"
     )

python_voiceio-0.2.3/voiceio/__init__.py

@@ -1 +0,0 @@
-__version__ = "0.2.3"