DOCUMENTATION · BAKEN.CA

Getting started with Baken

Baken is a native Android & Desktop client for stateful AI agents, built on Kotlin Multiplatform, encrypted Iroh peer-to-peer pairing, and git-backed agent memory.

1. Download & Install

All Android APKs and Desktop installers (Windows, macOS, Linux) publish to the single latest-release page:

Open GitHub Releases →

Note during the Meridian → Baken rename: release asset filenames are transitioning from meridian-desktop-* to baken-*. Bookmarking the /releases/latest link above always points to the newest build.

2. Pair your devices (QR over Iroh)

Baken connects directly to your agent host over Iroh QUIC — no public reverse proxy or hand-copied API tokens required.

  1. Start the host wrapper on your server or workstation.
  2. Generate a pairing invite QR code from the CLI or Desktop host.
  3. Scan from Baken on Android to establish a mutually authenticated peer connection.

3. Brand Mark & Mascot Architecture

Nothing in Baken is static, and no two indicators compete. Both baken-mark.riv and mascot.riv compile through the same Rive ViewModel pipeline and honor system reduceMotion.

Asset Role States Owned
baken-mark.riv App / Harbour / Connection idle, boot, loading (hydration only), connecting, degraded, ambient, success (peer lock)
mascot.riv Per-agent presence & turns listening, thinking, working, waitingInput, speaking, dreaming, sleeping, error, dragged