susurro 0.4.0__tar.gz

susurro-0.4.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,39 @@
+---
+name: Bug report
+about: Something is broken or behaving unexpectedly.
+title: "[bug] "
+labels: ["bug"]
+---
+
+**What happened**
+
+A clear and concise description of the bug.
+
+**Expected behavior**
+
+What you thought would happen.
+
+**Steps to reproduce**
+
+1.
+2.
+3.
+
+**Environment**
+
+- macOS version + chip (e.g. `macOS 26.0 / M3 Pro`):
+- Python version (`python --version`):
+- Susurro version (`pip show susurro | grep Version`):
+- Model in use (from `susurro/config.py`):
+
+**Logs**
+
+The last ~50 lines of `~/.susurro/susurro.log`:
+
+```
+paste log output here
+```
+
+**Additional context**
+
+Anything else worth knowing.

susurro-0.4.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Question or discussion
+    url: https://github.com/danilobrando/susurro/discussions
+    about: For usage questions, ideas, and conversations. Use Issues only for bugs and concrete feature requests.

susurro-0.4.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,22 @@
+---
+name: Feature request
+about: Suggest a new capability or improvement.
+title: "[feature] "
+labels: ["enhancement"]
+---
+
+**What you'd like**
+
+A clear description of the feature.
+
+**Why it matters**
+
+The use case this unlocks. Be concrete — "I want to dictate code comments in VS Code while my hands stay on the keyboard" is more useful than "more flexibility."
+
+**Alternatives considered**
+
+What you've tried instead, or other tools that solve this.
+
+**Scope check**
+
+Susurro aims to stay under ~800 lines of Python and avoid feature creep. Does this fit? If it adds significant surface area, what could be left out?

susurro-0.4.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,18 @@
+## Summary
+
+What this PR does and why.
+
+## Changes
+
+- 
+
+## Test plan
+
+- [ ] `ruff check .` passes
+- [ ] `ruff format --check .` passes
+- [ ] Manually exercised the affected code paths on macOS
+- [ ] If touching the daemon: held the hotkey, spoke, confirmed text was pasted at the cursor
+
+## Notes for reviewer
+
+Anything non-obvious — design tradeoffs, edge cases considered, things deliberately left out.

susurro-0.4.0/.github/workflows/ci.yml

@@ -0,0 +1,39 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    name: Lint + format
+    runs-on: macos-14
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install ruff
+        run: pip install ruff
+      - name: ruff check
+        run: ruff check .
+      - name: ruff format --check
+        run: ruff format --check .
+
+  smoke:
+    name: Smoke import test
+    runs-on: macos-14
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install package
+        # We can't actually install mlx on CI runners reliably (Apple Silicon
+        # availability varies), so we just verify the package metadata is sound
+        # and imports that don't need mlx work.
+        run: pip install --no-deps -e .
+      - name: Verify package metadata
+        run: python -c "import susurro; print(susurro.__version__)"

susurro-0.4.0/.gitignore

@@ -0,0 +1,41 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+.eggs/
+*.so
+dist/
+build/
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# Environment + secrets
+.env
+.env.local
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs + local state
+*.log
+.cache/
+
+# Tooling
+.coverage
+htmlcov/
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+
+# Packaged bundles (generated by py2app / briefcase)
+*.app/
+dist-app/
+
+# IDEs
+.idea/
+.vscode/

susurro-0.4.0/CHANGELOG.md

@@ -0,0 +1,84 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.4.0] — 2026-05-23
+
+### Changed
+
+- **Split into two products.** This package (`susurro` on PyPI) is now the OSS local-only Mac client. The cloud-extended product (`susurro-pro`) lives in a separate private repo, depends on this package, and adds hosted transcription via api.susurro.live. Same hotkey, same UX — different backend.
+- Default `STT_BACKEND` = `local` (was `groq`).
+- Default `POLISH_BACKEND` = `local` (was `groq`).
+- Removed `openai` and `httpx` dependencies (no more cloud calls from OSS).
+- Default `LOCAL_STT_MODEL` switched from `whisper-large-v3-mlx` to `whisper-large-v3-turbo` for ~6x faster decode.
+
+### Removed
+
+- `susurro/backends/susurro_pro.py` — moved to the susurro-pro package.
+- `susurro/backends/groq.py` — moved to the susurro-pro package.
+- `susurro/backends/audio_io.py` and `credentials.py` — used only by cloud backends, moved with them.
+- `api/` directory — FastAPI backend moved to the susurro-pro repo.
+- `docs/` directory — landing page moved to susurro-pro/landing/.
+- Root-level `Dockerfile`, `Caddyfile`, `railway.json` — Pro-only.
+- "Sign in to Susurro Pro" menu items — Pro adds these via `_extra_menu_items()` override.
+
+### Added
+
+- `susurro.backends.register_transcriber()` and `register_polish_llm()` — public extension points so external packages can add backends without forking.
+- `SusurroApp._build_menu()` and `_extra_menu_items()` — hook points so subclasses can extend the menu cleanly.
+- `available_transcribers()` / `available_polish_llms()` helpers.
+- Published to PyPI as `susurro`.
+
+## [0.2.0] — 2026-05-22
+
+### Added
+
+- **Hot-swappable backends.** STT and polish providers are now pluggable. Ships with `local` (MLX Whisper) and `groq` (hosted Whisper + Llama 3.3 70B). Future drops: OpenAI, Anthropic, Gemini, Deepgram.
+- **Cloud-first defaults.** `STT_BACKEND="groq"` and `POLISH_BACKEND="groq"` drop local RAM usage from ~3 GB to 0 GB. Latency improves from ~1.8 s to ~0.7 s end-to-end on a 5 s clip.
+- **Smart formatting (LLM polish).** Three modes (`off`/`rules`/`smart`). The LLM runs **only** when triggers fire (ordinal markers, backtrack phrases, long-form input) to keep latency low for the common case.
+- **Polish rules layer.** Regex-based filler removal (`eh`, `mmm`, `o sea sí`, `um`, `uh`, `este pues`) + whitespace normalization. Runs in <5 ms, no network.
+- **Polish trigger detection.** Detects Spanish/English ordinals (`primero/segundo/tercero`, `first/second/third`, `en primer lugar`) and self-correction phrases (`en realidad`, `actually`, `digo`).
+- **Polish system prompt.** Idempotent prompt with 5 few-shot examples covering numbered lists, filler removal, and backtrack. Refuses to paraphrase or translate.
+- **Polish event log.** Every (raw, polished, metadata) tuple appended to `~/.susurro/polish.jsonl` for local audit and future tuning. Never sent anywhere.
+- **Menu submenu: Smart formatting ▸ Off / Rules only / Smart (LLM).** Hot-toggle without restart.
+- **Fallback chain.** If a cloud backend fails (missing key, network error), automatically falls back to local MLX.
+- **Floating waveform indicator** (carried over from v0.1.x development). 16-bar pill, click-through, follows the active screen.
+- API key resolution accepts both `SUSURRO_<PROVIDER>_API_KEY` and the provider's standard env var.
+
+### Changed
+
+- **Tagline: dropped "local-first" as the default identity.** Susurro now positions as "your choice of where inference runs" — local for full privacy, cloud for low memory + low latency. Per-stage configuration.
+- Default `LOCAL_STT_MODEL` switched from `whisper-large-v3-mlx` to `whisper-large-v3-turbo` for ~6× faster local decode.
+- Package version bumped to 0.2.0.
+- `susurro/stt.py` removed; replaced by `susurro/backends/local_mlx.py` (`MLXTranscriber`).
+
+### Dependencies
+
+- Added `openai>=1.40` (used for both OpenAI and Groq via OpenAI-compatible API).
+- Added optional extras: `anthropic`, `gemini`, `deepgram`.
+
+## [0.1.0] — 2026-05-21
+
+## [0.1.0] — 2026-05-21
+
+### Added
+
+- Push-to-talk dictation triggered by the right Option key.
+- Local transcription via [`mlx-whisper`](https://github.com/ml-explore/mlx-examples/tree/main/whisper) (Apple Silicon only). Default model is `whisper-large-v3-mlx`; swap to `whisper-large-v3-turbo` in `susurro/config.py` for ~6× faster decode.
+- Menu bar app (rumps) with template PNG icons that adapt to light/dark mode.
+- Clipboard paste mode (Cmd+V) with prior-clipboard restoration, and a direct-typing fallback.
+- Status updates and last-transcript shortcut in the menu dropdown.
+- Quick-access menu items that open the correct System Settings pane for Microphone, Accessibility, and Input Monitoring.
+- File logging at `~/.susurro/susurro.log`.
+- Smoke test script: `scripts/test_mic.py`.
+
+### Known limitations
+
+- Apple Silicon only — Intel Macs aren't supported by MLX.
+- First launch requires three System Settings permission grants (Microphone, Accessibility, Input Monitoring) and a terminal restart.
+- No `.app` bundle yet; install via `pipx` or `pip` and launch from terminal.

susurro-0.4.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,7 @@
+# Code of Conduct
+
+This project follows the [Contributor Covenant 2.1](https://www.contributor-covenant.org/version/2/1/code_of_conduct/).
+
+In short: be kind, assume good faith, and remember the person on the other side of the screen is a human. Harassment, personal attacks, and demeaning behavior are not welcome and will result in being asked to leave the project.
+
+Issues with conduct can be reported privately to `dannybravo@gmail.com`. Reports are confidential and will be reviewed within 72 hours.

susurro-0.4.0/CONTRIBUTING.md

@@ -0,0 +1,58 @@
+# Contributing to Susurro
+
+Thanks for considering a contribution. Susurro is intentionally small — under ~800 lines of Python total — so it stays readable and maintainable by one person in a weekend.
+
+## Dev setup
+
+```bash
+git clone https://github.com/danilobrando/susurro
+cd susurro
+pip install -e ".[dev]"
+```
+
+Run from source:
+
+```bash
+python -m susurro
+```
+
+Generate the menu bar icons (only needed if you change `scripts/generate_icons.py`):
+
+```bash
+python scripts/generate_icons.py
+```
+
+Run lint and format checks:
+
+```bash
+ruff check .
+ruff format --check .
+```
+
+## Pull request guidelines
+
+- Keep the surface area small. If a change adds more than ~100 lines, open an issue first to align on scope.
+- One concern per PR. Refactors and behavior changes don't mix.
+- Don't add hidden network calls — privacy is the product. Anything that touches the network needs to be opt-in and clearly labeled.
+- Match the existing style: type hints throughout, no docstrings longer than a sentence, no comments that just restate the code.
+
+## What we welcome
+
+- Bug fixes, especially around macOS permissions and menu bar edge cases.
+- New keyboard layouts and language defaults.
+- Performance benchmarks across M-series chips and Whisper variants.
+- Documentation improvements.
+
+## What we're more cautious about
+
+- New features that grow the dependency tree.
+- Anything that turns this into a full Speech-Privacy SaaS. There are other projects for that.
+
+## Reporting bugs
+
+Open an issue with:
+
+- macOS version + chip (e.g. `macOS 26.0 / M3 Pro`)
+- Output of `pip show mlx-whisper`
+- Last 50 lines of `~/.susurro/susurro.log`
+- Steps to reproduce

susurro-0.4.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Danny Bravo
+
+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.

susurro-0.4.0/PKG-INFO

@@ -0,0 +1,233 @@
+Metadata-Version: 2.4
+Name: susurro
+Version: 0.4.0
+Summary: Local voice dictation for macOS. Whisper + Llama 3.2 3B run on-device via Apple's MLX framework. No accounts, no API keys, no network.
+Project-URL: Homepage, https://github.com/danilobrando/susurro
+Project-URL: Repository, https://github.com/danilobrando/susurro
+Project-URL: Issues, https://github.com/danilobrando/susurro/issues
+Project-URL: Changelog, https://github.com/danilobrando/susurro/blob/main/CHANGELOG.md
+Author: Danny Bravo
+License-Expression: MIT
+License-File: LICENSE
+Keywords: apple-silicon,dictation,local-first,macos,menu-bar,mlx,offline,privacy,speech-to-text,stt,whisper
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: MacOS X
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Requires-Dist: mlx-lm>=0.21
+Requires-Dist: mlx-whisper>=0.4
+Requires-Dist: mlx>=0.21
+Requires-Dist: numpy>=1.26
+Requires-Dist: pynput>=1.7
+Requires-Dist: rumps>=0.4
+Requires-Dist: sounddevice>=0.4
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == 'dev'
+Requires-Dist: pillow>=10.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Requires-Dist: twine>=5.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Susurro
+
+> **Local voice dictation for macOS. Fully offline. MIT licensed.**
+
+Hold a hotkey, talk, release. The transcript is polished into structured text — ordinals become numbered lists, fillers get stripped, self-corrections get applied — and pasted at the cursor in any app. Everything runs on your Mac through Apple's MLX framework. No accounts, no API keys, no network.
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![macOS](https://img.shields.io/badge/macOS-13%2B-blue)]()
+[![Apple Silicon](https://img.shields.io/badge/Apple%20Silicon-required-success)]()
+[![Python](https://img.shields.io/badge/Python-3.10%2B-blue)]()
+[![Version](https://img.shields.io/badge/version-0.4.0-success)](https://github.com/danilobrando/susurro/releases/latest)
+[![PyPI](https://img.shields.io/pypi/v/susurro.svg)](https://pypi.org/project/susurro/)
+[![Landing](https://img.shields.io/badge/site-susurro.live-white)](https://susurro.live)
+
+## Install (one line)
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/danilobrando/susurro/main/install.sh | bash
+```
+
+Or with `pipx`:
+
+```bash
+pipx install susurro
+susurro
+```
+
+After install, hold the **right Option key (⌥)** to dictate. The first launch downloads Whisper + Llama weights (~5 GB total, one-time) and triggers three macOS permission prompts (Microphone, Accessibility, Input Monitoring).
+
+## Why Susurro
+
+- **Fully offline.** Audio never leaves your machine. No telemetry, no analytics, no cloud calls during normal use.
+- **WisprFlow-grade smart formatting.** An LLM polishes the raw transcript: ordinals become numbered lists, fillers like "um/eh/o sea" get removed, self-corrections ("Pedro, eh, Pablo digo") collapse to the final intent.
+- **Auditable.** Every (raw → polished) edit is logged locally to `~/.susurro/polish.jsonl`. Nothing is hidden.
+- **MIT licensed.** Read the code, fork it, redistribute it.
+
+If you want zero local RAM + lower latency at the cost of cloud transcription, [Susurro Pro](https://susurro.live) is a paid hosted variant that extends this package.
+
+## Requirements
+
+- Apple Silicon Mac (M1 or later). MLX doesn't support Intel.
+- macOS 13+ recommended (tested on 26).
+- Python 3.10+.
+- ~5 GB free disk (one-time model download).
+- ~3 GB free RAM while running.
+
+## Usage
+
+1. Click into any text field.
+2. **Hold the right Option key (⌥)** and speak.
+3. **Release.** After ~1.5 s, the polished transcript pastes at the cursor via Cmd+V.
+
+While recording, a small dark **waveform pill** appears near the bottom of the active screen, with 16 white bars rippling to your voice. Toggle off via the *Show waveform indicator* menu item.
+
+Menu bar icon reflects state:
+
+| Icon | Meaning |
+|---|---|
+| 🎙 idle | Ready. Hold the hotkey to record. |
+| 🔴 recording | Listening. Release to transcribe. |
+| ⏳ processing | Transcribing + polishing on-device. |
+
+## Smart formatting
+
+The polish step turns raw dictation into structured text. Three modes (switchable from the menu):
+
+- **Off** — paste raw STT output unchanged.
+- **Rules only** — regex cleanup: filler removal (`eh`, `mmm`, `o sea sí`, `um`, `uh`), whitespace normalization. <5 ms.
+- **Smart (LLM)** — rules + local Llama 3.2 3B polish, but only when triggers fire (ordinal markers, backtrack phrases, long-form input). Otherwise stays rules-only to keep latency low.
+
+Example (`smart` mode):
+
+```
+Raw:   "Vamos a seguir tres pasos. Primero, reinicia. Segundo, vuelve a registrarte. Tercero, envía un correo."
+
+Polished:
+Vamos a seguir tres pasos.
+
+1. Reinicia
+2. Vuelve a registrarte
+3. Envía un correo
+```
+
+## Configuration
+
+Edit `susurro/config.py`:
+
+- **`STT_BACKEND`** — `local` (default). Extension packages can register more.
+- **`POLISH_MODE`** — `smart` (default), `rules`, or `off`.
+- **`LOCAL_STT_MODEL`** — `whisper-large-v3-turbo` (default), or `whisper-large-v3-mlx` for max accuracy.
+- **`LOCAL_POLISH_MODEL`** — `Llama-3.2-3B-Instruct-4bit` (default), or any mlx-community 3B-class model.
+- **`HOTKEY`** — `alt_r` (default). Any pynput `Key` name: `alt_l`, `ctrl_r`, `f19`, etc.
+- **`LANGUAGE`** — `None` for auto-detect, or pin to `"es"` / `"en"` to save ~100 ms per request.
+- **`INPUT_DEVICE`** — pick a specific mic. Run `python -m sounddevice` to list devices.
+
+## Permissions
+
+macOS will prompt for three permissions the first time you run Susurro:
+
+1. **Microphone** — to capture your voice.
+2. **Accessibility** — to paste the transcript into the focused app.
+3. **Input Monitoring** — to listen for the global hotkey.
+
+After granting any of these, **fully quit and relaunch your terminal** for the new permission to take effect. The menu bar has direct links to each pane.
+
+## Architecture
+
+```
+audio (sounddevice → 16kHz mono float32)
+    → MLX Whisper (whisper-large-v3-turbo, on-device)
+    → raw text
+    → Polisher
+        ├ Tier 1: regex rules (filler removal, whitespace)
+        ├ Tier 2: trigger check (ordinals / backtrack / long-form)
+        └ Tier 3: MLX-LM polish (Llama 3.2 3B Instruct, on-device)
+    → polished text
+    → clipboard write + Cmd+V into focused app
+```
+
+Source layout — under ~1500 lines of Python total:
+
+```
+susurro/
+  config.py            # all tunables
+  audio.py             # mic capture + peak_level for indicator
+  hotkey.py            # pynput global hotkey
+  typer.py             # clipboard / keystroke insertion
+  indicator.py         # floating waveform pill (PyObjC)
+  permissions.py       # System Settings deep links
+  app.py               # rumps menu bar + main loop (subclassable)
+  backends/
+    base.py            # protocols (Transcriber, PolishLLM)
+    local_mlx.py       # local Whisper via MLX
+    local_mlx_lm.py    # local polish LLM via mlx-lm
+    __init__.py        # factories + extension registration
+  polish/
+    __init__.py        # Polisher orchestrator
+    rules.py           # regex cleanup
+    triggers.py        # decides if LLM should fire
+    prompt.py          # system prompt + few-shot examples
+  icons/               # template PNGs for menu bar
+```
+
+## Extending Susurro
+
+External packages can register additional backends without modifying this code:
+
+```python
+# in your_extension/__init__.py
+from susurro.backends import register_transcriber, register_polish_llm
+
+class MyCloudSTT:
+    name = "mycloud"
+    def warmup(self): ...
+    def transcribe(self, audio): ...
+
+register_transcriber("mycloud", lambda: MyCloudSTT())
+```
+
+Then set `STT_BACKEND = "mycloud"` in `susurro/config.py` or via environment.
+
+## Troubleshooting
+
+- **Menu bar icon invisible** — emoji-only menu bar items can be hidden on MacBooks with a notch. This release ships a real template PNG, which fixes it for most users.
+- **"This process is not trusted"** — Accessibility permission isn't granted. Use the *Open Accessibility Settings…* menu item, then fully restart the terminal.
+- **Hotkey doesn't trigger** — Input Monitoring permission is missing.
+- **Silent recordings / empty transcript** — Microphone permission is missing, or `INPUT_DEVICE` is pointing at the wrong device.
+- **First transcription is slow** — the model is still warming up. Wait until the menu shows *Status: idle* before the first real dictation.
+
+Logs land in `~/.susurro/susurro.log`; polish events in `~/.susurro/polish.jsonl`.
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md). PRs welcome; please keep the package under ~1500 lines.
+
+## Security
+
+See [SECURITY.md](SECURITY.md). Report vulnerabilities privately to the maintainer.
+
+## Maintainer
+
+Built and maintained by [Danny Bravo](https://github.com/danilobrando) (`dannybravo@gmail.com`). Product strategist, AI ecosystem builder, educator — based in Bogotá.
+
+## License
+
+[MIT](LICENSE) © 2026 Danny Bravo.
+
+## Credits
+
+- [ml-explore/mlx](https://github.com/ml-explore/mlx) and [mlx-examples/whisper](https://github.com/ml-explore/mlx-examples/tree/main/whisper) — Apple's MLX framework and the MLX Whisper port.
+- [OpenAI Whisper](https://github.com/openai/whisper) — the model.
+- [Meta Llama 3.2](https://www.llama.com/) — the polish LLM.
+- [rumps](https://github.com/jaredks/rumps), [pynput](https://github.com/moses-palmer/pynput), [sounddevice](https://github.com/spatialaudio/python-sounddevice) — Python ↔ macOS glue.
+- WisprFlow and SuperWhisper — the product UX this clones.