Repository navigation
v2.49.0
Local, offline voice dictation. Hold a key, speak, release. No cloud, no GPU.
Verify your download
SHA256SUMS.txt below lists the hash of every artifact in this release.
How to check it, how release binaries are signed, and who approves a
signing request: Code signing policy & verification.
macOS
Download the .dmg for your Mac from the Assets below — …-macos-arm64.dmg
for Apple Silicon, …-macos-x86_64.dmg for Intel — open it, and drag
YazSes.app into Applications.
Not sure which? Run uname -m in Terminal. If no Intel .dmg is attached,
that build did not succeed for this release; pipx install yazses works on
both architectures.
On first launch, right-click → Open (this build is not code-signed
yet — verify it with the attestation linked above instead). Grant
Accessibility + Microphone when prompted.
Default hotkey: Right Option. Full guide: docs/macos-install.md.
Windows
Download …-windows-x64.exe from the Assets below. It is the installer for
an Intel or AMD PC, and it also runs on an ARM PC (Snapdragon, Surface Pro X
and similar) under Windows' emulation: there is no native ARM build because
the speech engine publishes no ARM Windows wheel yet.
SmartScreen may say "unrecognized app" — click More info → Run anyway
(this build is not code-signed yet — verify it with the attestation linked
above instead). Default hotkey: Right Ctrl. Full guide:
docs/windows-install.md.
Linux
One-line installer (Debian/Ubuntu):
bash <(curl -fsSL https://raw.githubusercontent.com/MSKazemi/yazses/main/install.sh)APT repository:
curl -fsSL https://raw.githubusercontent.com/MSKazemi/yazses/gh-pages/apt/KEY.gpg \
| sudo gpg --dearmor --yes -o /usr/share/keyrings/yazses.gpg
echo "deb [signed-by=/usr/share/keyrings/yazses.gpg] https://raw.githubusercontent.com/MSKazemi/yazses/gh-pages/apt ./" \
| sudo tee /etc/apt/sources.list.d/yazses.list
sudo apt update && sudo apt install yazses
sudo usermod -aG input $USER && logout
systemctl --user enable --now yazses.serviceSnap:
sudo snap install yazses --classic
sudo usermod -aG input $USER && logoutpipx (any Linux):
sudo apt install pipx libportaudio2 xdotool xclip
sudo usermod -aG input $USER && logout
pipx install yazses && pipx ensurepath
systemctl --user enable --now yazses.service.deb package:
sudo apt install ./yazses_*.deb
sudo usermod -aG input $USER && logout
systemctl --user enable --now yazses.serviceDefault hotkey on Linux: Right Alt (configurable). Default config lives
at ~/.config/yazses/config.toml.
AI assistants (MCP)
yazses-<version>.mcpb in the Assets below connects YazSes to a desktop MCP
client: open the file with the client. It contains no copy of YazSes; it runs
the yazses mcp-server command of the YazSes you installed above, so install
that first. If your client does not accept the bundle, add the server by hand.
Guide: docs/how-to/connect-mcp-client.md.
What's Changed
📱 Android
📦 Packaging & distribution
- chore(packaging): refresh the package manifests for v2.48.1 by @MSKazemi in #820
- fix(release-channels): decide Docker from the exact manifest, not the first page of tags (Refs #844) by @MSKazemi in #848
⚙️ Settings GUI
- fix(settings): the Updates page line names the button and says what the check asks by @MSKazemi in #847
- fix(settings): the Speech page says why the Language box is greyed by @MSKazemi in #852
- fix(settings): the Features search hint explains its filters in words by @MSKazemi in #853
- feat(settingsui): hands-free controls become the Hands-free settings page, two columns when wide by @MSKazemi in #772
📚 Documentation
- fix(docs): design pages stop publishing a cut-off or fragment meta description by @MSKazemi in #841
- research(#696): BrainFlow synthetic-board probe and adversarial transport replay by @MSKazemi in #822
- test(biosignal): pin runner dead time after a backlog discard and same-block release+blink by @MSKazemi in #834
- fix(biosignal): refuse a Butterworth design that rounds onto the unit circle by @MSKazemi in #835
- fix(biosignal): exact Poisson upper bound for false-activation rates by @MSKazemi in #836
- fix(biosignal): hostile or corrupt recordings fail with a clear error by @MSKazemi in #837
- test(biosignal): pin which synthetic shapes the EMG onset detector fires on by @MSKazemi in #838
- research(#255): semantic-fidelity protocol and synthetic-only evaluation harness by @MSKazemi in #825
- docs(research): EEG/EOG evidence review and proposed no-actuation ADR (#696) by @MSKazemi in #821
- docs(roadmap): evidence-gated roadmap with accessible status diagrams by @MSKazemi in #842
- docs(roadmap): maturity grid and promises diagram for The destination by @MSKazemi in #840
- docs(research): audit local ASR runtimes and model provenance (#792) by @MSKazemi in #845
- research(#803): agent/MCP trust boundaries, audible-budget lifetime and replay oracle by @MSKazemi in #850
- docs(adr): propose a reproducibility gate for offline ASR comparisons (#793) by @MSKazemi in #851
- research(#796): streaming endpointing and commit safety, replay oracle by @MSKazemi in #854
- docs: stale-claims sweep (EMG over-claims, release pointers, shipped-as-proposed) by @MSKazemi in #846
- docs(homepage): replace the four-era progress roadmap with evidence-backed status cards by @MSKazemi in #849
- research(eeg): BCI feasibility note and synthetic motor-imagery negative-control replay (#696) by @MSKazemi in #855
- design(#826): ThinkGear first-device qualification plan, ADR-v2-155 by @MSKazemi in #856
- ci(test): run the macOS 3.11 leg on main and manual runs only by @MSKazemi in #857
Other changes
- test: make the click-observer Quartz test independent of test order by @MSKazemi in #823
- test: stop the stale-permissions doctor tests depending on the host's pid 4242 by @MSKazemi in #824
Full Changelog: v2.48.1...v2.49.0