Hufu home
Install Hufu on your Mac.
Hufu 0.1.0 is available for macOS 15.0+. The current build is an unsigned preview; right-click › Open it the first time. Verification and installation steps are below.
Hufu 0.1.0
Preview · unsignedReleased 2026-10-21. This is an ad-hoc preview build without Apple notarization. Right-click › Open it the first time, or allow it under System Settings › Privacy & Security. Signing and notarization follow once a developer account is available.
SHA-256 · Hufu-0.1.0.pkg
5ee20c245b12f1abde3ce3c552232e057952d86443a045dd833d271b68deabaaSystemmacOS 15.0+
ChipApp: Apple silicon and Intel (universal binary)hufu command-line tool: Apple silicon and Intel
LicenceMIT · dependencies keep their licences
Install step by step.
- Download the installer and SHA256SUMS.txt from the same folder. Run this command to verify it.
shasum -a 256 -c SHA256SUMS.txt --ignore-missing - Double-click the installer and follow the prompts. If Gatekeeper blocks the unsigned package, clear its quarantine attribute in Terminal:
xattr -d com.apple.quarantine Hufu-0.1.0.pkg - Open System Settings → Keyboard → Input Sources → Edit…, click + and add Hufu under Chinese, Simplified. If it is missing after the first install, log out and back in.
Or build from source.
Requires Xcode 26+ and XcodeGen. The script downloads and verifies pinned dependencies, then builds and registers the input method. The build uses ad-hoc signing.
git clone https://github.com/syhily/hufu.git && cd hufu
bash scripts/install-dev.shAfter an update, macOS starts the input process when you next type. Do not start it manually.
Settings and migration