Installation
Download a signed build for macOS, Windows, or Linux, or build Suzuri from source.
Download
Grab the latest installer from the releases page:
| Platform | Asset |
|---|---|
| macOS — Apple Silicon | suzuri-aarch64.dmg |
| macOS — Intel | suzuri-x86_64.dmg |
| Windows | suzuri-windows-x86_64.exe |
| Linux — x86_64 | suzuri-linux-x86_64.tar.gz |
| Linux — ARM64 | suzuri-linux-aarch64.tar.gz |
The macOS builds are Developer ID signed and notarized. Open the DMG and drag Suzuri to Applications — Gatekeeper will not complain.
That first install is the only manual one — see Updating for how Suzuri keeps itself current.
Open a folder
Suzuri works on a folder of plain files, which the docs call a vault: your
notes, the PDFs you read, a refs/ folder for your bibliography, and whatever
code lives alongside them. There is no import step and no proprietary database.
To try it against known fixtures, clone suzuri-testbed and open that folder. Each folder targets one rendering surface — markdown live preview, Python REPL and notebook execution, LaTeX and Typst preview, the PDF viewer — and several fixtures are self-checking notes with a checklist at the top, so you can verify behavior by eye.
Build from source
Suzuri builds exactly the way Zed does. Follow Zed's platform guides against this repository:
Then:
cargo run # debug build (slow, fine for iteration)
cargo run --profile release-fast # the profile used day to day