Build from source

Kudu is open source (MIT). The Mac app is Swift; the Windows and Linux app is Rust. Both live in one repository.

git clone https://github.com/manasdutta04/kudu.git && cd kudu

macOS

Needs Swift 6.2 or newer (Xcode or the Command Line Tools) on an Apple Silicon Mac.

cd macos && scripts/build-app.sh && open build/Kudu.app

To keep the Accessibility permission across rebuilds, sign with a stable certificate: scripts/setup-dev-signing.sh creates one.

Install Rust, the Visual Studio Build Tools (“Desktop development with C++”) and CMake.

PowerShellcd desktop; cargo build --release; .\target\release\kudu.exe

Ubuntu

sudo apt install build-essential pkg-config cmake libasound2-dev libssl-dev libxkbcommon-dev libwayland-dev libx11-dev libdbus-1-dev

Fedora

sudo dnf install gcc-c++ pkgconf cmake alsa-lib-devel openssl-devel libxkbcommon-devel wayland-devel libX11-devel dbus-devel

cd desktop && cargo build --release && ./target/release/kudu

Without CMake you can build without smart formatting: cargo build --release --no-default-features.

`macos/`	The Mac app: SwiftUI and AppKit, speech on the Neural Engine, Apple Intelligence.
`desktop/crates/kudu-core`	The text pipeline, shortcuts and learning, shared by Windows and Linux.
`desktop/crates/kudu-engine`	Microphone, speech recognition (sherpa-onnx), the optional language model (llama.cpp).
`desktop/crates/kudu-app`	The app: background process, Windows and Linux layers, overlay, tray and the settings window.

Contributions are welcome: see CONTRIBUTING.md.

← Troubleshooting