Reading the repo

Opening the box…

How to set up Handy (cjpais/Handy) · gitmanual

Assembly instructions

cjpais/Handy

A free, open source, and extensible speech-to-text application that works completely offline.

Node.jsTauriVite#accessibility#cross-platform#speech-to-text#tauri-v2

Difficulty: Moderate
Time: about 15 min
Stars: ★ 37,545
Activity: Updated this month
License: MIT
Open issues: 185
Got it running: Be the first
Looked up: 2 h ago

Saved setup from 2 h ago

Start here

Website ↗handy.computerThe project's own site.

Will it work on my device?

Yes, it installs on your macOS

A ready-made macOS download is in the latest release.

Checking for

Download for macOS

v0.10.0 · 11/2/2026 ↗

Handy_0.10.0_aarch64.dmg

dmg · Apple Silicon · 14.8 MB · 14,280 downloads · best match

Download

Drag the app into Applications.

curl -LO "https://github.com/cjpais/Handy/releases/download/v0.10.0/Handy_0.10.0_aarch64.dmg"
open "Handy_0.10.0_aarch64.dmg"

Other macOS downloads (1)

Handy_0.10.0_x64.dmg

dmg · Intel · 15.1 MB · 836 downloads

Download

Drag the app into Applications.

curl -LO "https://github.com/cjpais/Handy/releases/download/v0.10.0/Handy_0.10.0_x64.dmg"
open "Handy_0.10.0_x64.dmg"

Install with a package manager

Homebrew

brew install --cask handy

From the README, exactly as the maintainers wrote it.

Did you get it running?

No reports for macOS yet.

Still stuck? Get a written guide

Claude reads the 9 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.

Parts list

1×Node.js LTS (no version pinned)runtime
1×Bun runtime
1×Rust stableruntime
1×bun package manager

Share this manual

Good to know

Tauri desktop app: it also needs Tauri's system prerequisites (Xcode Command Line Tools on macOS, WebView2 and the C++ build tools on Windows, webkit2gtk on Linux). See https://tauri.app/start/prerequisites/
Has AGENTS.md — instructions for coding agents. You can open Claude Code (or another agent) in the cloned folder and ask it to do the setup for you.
Nested projects: src-tauri/Cargo.toml

package.json scripts (20)

devvite
buildtsc && vite build
previewvite preview
tauritauri
linteslint src
lint:fixeslint src --fix
formatprettier --write . && cd src-tauri && cargo fmt
format:checkprettier --check . && cd src-tauri && cargo fmt -- --check
format:frontendprettier --write .
format:backendcd src-tauri && cargo fmt
test:keyboardbun src/lib/utils/keyboard.test.ts
test:playwrightplaywright test
test:playwright:uiplaywright test --ui
check:translationsbun scripts/check-translations.ts
check:model-languagesbun scripts/check-model-language-coverage.ts
sync:catalogbun scripts/sync-catalog.ts
check:catalogbun scripts/sync-catalog.ts --check
build:cjk-fontbun scripts/build-cjk-font.ts
check:cjk-fontbun scripts/build-cjk-font.ts --check
postinstallbun scripts/check-nix-deps.ts

Files we read (9)

.github/workflows/build-test.yml

.github/workflows/build.yml

.github/workflows/main-build.yml

.github/workflows/nix-check.yml

.github/workflows/pr-test-build.yml

.github/workflows/test.yml

BUILD.md

README.md

package.json

Branch main · 484 files in the repo