FOUNDATIONS?CHAPTER 02

Getting Started

A step-by-step walkthrough to initialize the Kanna daemon, bind your first terminal session, and verify the latent anchor lock.

Getting up and running with Kanna requires a single terminal binary and a local configuration file. This guide walks you through the verification process.

Prerequisites

Ensure your workstation meets the baseline hardware requirements:

macOS: Apple Silicon (M1, M2, M3, M4 series) with macOS 14.0+ and Metal Unified Memory.
Linux: Ubuntu 22.04+ or Arch Linux with NVIDIA Driver 535+ and CUDA 12.0+.
Windows: Windows 11 with WSL2 or native Vulkan 1.3 runtime.

Quick Start in 3 Steps

1. Download and Install Binary

TERMINAL CODE

# Install Kanna via Homebrew or Curl
curl -fsSL https://kanna.musemvp.cn/install.sh | sh

2. Initialize the Local Workspace

Run the initialization wizard to generate your default configuration:

TERMINAL CODE

kanna init

This creates your configuration at ~/.config/kanna/daemon.toml and verifies hardware acceleration.

3. Bind to Your Active Terminal

TERMINAL CODE

kanna daemon start

You should observe the following confirmation in your terminal:

TERMINAL CODE

[INFO] Kanna Alter-Ego Daemon v0.9.4 initialized
[INFO] Unified memory mapped: 1.42 GB (Metal MPS)
[INFO] Latent Anchor Lock: ACTIVE (Seed #90210)
[INFO] Terminal session bound to /dev/ttys002

For detailed configuration parameters, visit the Configuration Specification.