ARCHITECTURE?CHAPTER 03

Installation Guide

Detailed platform-specific instructions for compiling from source, package managers, and setting up systemd or launchd services.

Kanna is distributed as a pre-compiled Rust binary with zero runtime dependencies. It can be installed via package managers or compiled directly from source.

Package Managers

macOS (Homebrew)

TERMINAL CODE

brew tap musemvp/kanna
brew install kanna

Arch Linux (AUR)

TERMINAL CODE

paru -S kanna-bin

Pre-compiled Linux Binary

TERMINAL CODE

wget https://github.com/musemvp/kanna/releases/latest/download/kanna-linux-x86_64.tar.gz
tar -xvf kanna-linux-x86_64.tar.gz
sudo mv kanna /usr/local/bin/

Building From Source

If you require custom Metal shaders or specialized CUDA compute capabilities:

TERMINAL CODE

git clone https://github.com/musemvp/kanna.git
cd kanna
cargo build --release --features mps,cuda
sudo cp target/release/kanna /usr/local/bin/

System Service Integration

To keep Kanna active across reboots:

TERMINAL CODE

# On macOS via launchd
kanna service install

# On Linux via systemd user unit
systemctl --user enable --now kanna.service