⚠️ 项目已停止开发 / Project Discontinued本项目不再继续开发，已迁移到新项目 Air Talk，请前往新仓库获取最新进展。
This project is no longer maintained. Development has moved to Air Talk — please head there for the latest work.
Fork of Koe (声) — bringing voice-to-text input to Windows.
The original Koe is a macOS-native voice input tool built with Objective-C + Rust. This fork adds Koe Shell (koe-shell), a pure Rust desktop shell that replaces the macOS Objective-C layer, making Koe work on Windows with the same core engine.
| Upstream (missuo/koe) | This Fork | |
|---|---|---|
| Platform | macOS only (Objective-C shell) | Windows (Rust shell) |
| UI | Native macOS menu bar + overlay | System tray + Win32 overlay |
| Binary | Koe.app (Xcode build) |
koe.exe single binary (cargo build) |
| Core engine | Same koe-core Rust library |
Same koe-core Rust library |
| ASR | All providers | Cloud + sherpa-onnx (no MLX/Apple Speech) |
The key insight: koe-core (ASR, LLM, config, session management) is already pure Rust. Only the thin "shell" layer needed to be rewritten for Windows.
For configuration, prompts, dictionary, local models, and other features shared with upstream, see the upstream README.
Download the latest binary from GitHub Releases:
- Windows:
koe-<version>-x86_64-pc-windows-msvc.zip
Unzip and run koe.exe. No installation needed.
Prerequisites:
- Rust toolchain (
rustup) - Visual Studio Build Tools (for MSVC)
git clone https://github.com/jeffcaiz/koe.git
cd koe
cargo build --release --package koe-shell
# Binary at: target/release/koe.exe- Run
koe.exe— a system tray icon appears - Press the hotkey (default: Right Alt) to start recording
- Speak — audio streams to the ASR service in real-time
- Release the hotkey — corrected text is pasted into the active input field
First-time setup is done through the Settings UI, accessible from the system tray menu.
All config lives in %APPDATA%\koe\, same format as the original Koe. See the upstream documentation for full config reference.
┌─────────────────────────────────────────┐
│ Koe Shell (Rust) │
│ ┌──────────┐ ┌────────┐ ┌───────────┐ │
│ │ Hotkey │ │ Audio │ │ Clipboard │ │
│ │ (rdev) │ │ (cpal) │ │ + Paste │ │
│ └────┬─────┘ └───┬────┘ └─────▲─────┘ │
│ │ │ │ │
│ ┌────▼────────────▼────────────┴─────┐ │
│ │ koe-core (Rust) │ │
│ │ ASR · LLM · Config · Sessions │ │
│ └────────────────────────────────────┘ │
│ │
│ ┌──────────┐ ┌──────────┐ ┌─────────┐ │
│ │ Tray │ │ Overlay │ │ Settings│ │
│ │(tray-icon)│ │ (Win32) │ │ (axum) │ │
│ └──────────┘ └──────────┘ └─────────┘ │
└─────────────────────────────────────────┘
Releases are automated via GitHub Actions. To create a new release:
git tag v0.x.x
git push fork v0.x.xThis triggers CI to build Windows binaries and publish them as a GitHub Release.
MIT — same as upstream.