Repository navigation
v2.48.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
- feat(biosignal): experimental artifact switches, off by default by @MSKazemi in #755
- docs: correct pages that still described the repository as it was before 2.47.0 by @MSKazemi in #759
🗣️ Speech & models
📦 Packaging & distribution
- chore(release): refresh the packaging manifests for v2.47.0 by @MSKazemi in #747
- chore(ci): bump the actions group with 14 updates by @dependabot[bot] in #750
- chore(deps): take the 2026-11-01 dependency updates, except PySide6 6.12 by @MSKazemi in #761
- release: v2.48.0 by @MSKazemi in #765
📚 Documentation
- docs site: per-page descriptions and search-sized titles for the engineering pages by @MSKazemi in #757
- docs site: end shortened design titles at a clause, never on a fragment (follow-up to #757) by @MSKazemi in #758
- feat(residency): the latency governor's extra model can be released when idle (ADR-029 step 2) by @MSKazemi in #760
- docs(l10n): de and id pages no longer promise voice commands those languages lack by @MSKazemi in #762
- docs(l10n): 20 more pages no longer promise voice commands their language lacks by @MSKazemi in #764
Other changes
Full Changelog: v2.47.0...v2.48.0