Setup Guide

Installation & Prerequisites

Follow these instructions to configure system dependencies and compile the Kyro desktop application.

Platform Status: Pre-built packages are currently available for Linux distributions (.deb and .AppImage). Official installers for macOS and Windows are coming soon! You can compile and run Kyro from source today on Linux, macOS, or Windows using the instructions below.

Core Toolchain Requirements

Node.js: ≥ 20.x (Node 22 recommended) with npm
Rust: ≥ 1.75.0 (stable toolchain: rustc, cargo)
Git: Standard git command-line tool

OS-Specific System Packages

Ubuntu / Debian

Tauri v2 and the native computer-use subsystem require WebKit2GTK 4.1, XDO mouse emulation, and SSL headers:

Terminal (Ubuntu/Debian)

sudo apt-get update && sudo apt-get install -y \
  libwebkit2gtk-4.1-dev \
  build-essential \
  curl \
  wget \
  file \
  libxdo-dev \
  libssl-dev \
  libayatana-appindicator3-dev \
  librsvg2-dev \
  xvfb

macOS

Install the standard Xcode command line developer tools:

Terminal (macOS)

xcode-select --install

Windows

Windows requires the Microsoft C++ Build Tools and the Edge WebView2 runtime:

• Microsoft C++ Build Tools (MSVC v143+)
• Microsoft Edge WebView2 Runtime (standard on Windows 11)

Building from Repository

Terminal

# 1. Clone the repository
git clone https://github.com/eshanized/Kyro.git
cd Kyro

# 2. Install Node dependencies
npm install

# 3. Launch the full desktop application in development
make dev

# Or run the Vite frontend standalone in browser
make dev-ui

Verification Pipeline

Before submitting pull requests or packaging releases, execute Kyro's unified verification target:

Terminal

make verify

This runs: formatting check (rustfmt), strict Clippy linting (-D warnings), 230+ Rust unit and integration tests, frontend Vitest tests, and production build checks.