Download Tachyonn

Every release ships two things: the desktop app and the command-line
tool. They are separate binaries — installing one does not install the other.

Latest release

Download the latest release →

That link always points at the newest version, so it's safe to bookmark. The
full history lives on the
Releases page, and the raw
artifacts in the
Package Registry.

What's in a release

Artifact	What it is
tachyonn_<version>_aarch64.dmg	The desktop app, for macOS on Apple Silicon
tachyonn-cli-<version>-aarch64-apple-darwin.tar.gz	The tachyonn command-line tool

Installing the app

Open the .dmg and drag tachyonn.app into your Applications folder. macOS
does not do this step for you — it's manual for every app, not just this one.

First launch

The app is not signed or notarized. Double-clicking it will show a warning
that macOS "cannot verify the developer". Right-click (or Control-click) the
app and choose Open instead — you only have to do this once.

This is the normal cost of a build that isn't paying for an Apple Developer
account, not a sign that anything is wrong.

Installing the CLI

Unpack the archive and put the binary somewhere on your PATH:

tar -xzf tachyonn-cli-<version>-aarch64-apple-darwin.tar.gz
mv tachyonn ~/.local/bin/    # or /usr/local/bin, or anywhere on your PATH

Check it worked:

tachyonn --version

The CLI is what gives you tachyonn preview (the live, hot-reloading view you
write against), tachyonn export for PDFs
and images, and the housekeeping commands
unused-images and paste-image.

Building from source

Tachyonn is a Rust workspace with a Nuxt frontend. If you'd rather build it
yourself:

git clone https://gitlab.com/port0/tachyonn.git
cd tachyonn
make build

make build produces the app bundle in target/release/bundle/ and
installs the CLI into ~/.cargo/bin/. make build-app and make build-cli do
one each.

You'll need a Rust toolchain (via rustup), Node 22+, and
the Tauri CLI (cargo install tauri-cli).

Other platforms

Releases today are macOS on Apple Silicon only — that's the machine
Tachyonn is developed on, and the one its builds are verified against.

Nothing in the codebase is macOS-specific: it's Rust plus Tauri plus Nuxt, all
of which run on Linux and Windows. Building from source on those platforms
should work; it just isn't something the project tests, so treat it as
unsupported rather than impossible.