Installation

This guide covers how to install Kuse Cowork on your system.

System Requirements

Minimum Requirements

‍

Recommended Requirements

Installation Methods

Build from Source

Prerequisites

macOSLinuxWindows

macOS

# Install Homebrew if not installed
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install dependencies
brew install node pnpm rust

# Install Tauri CLI
cargo install tauri-cli

‍

Linux

# Install dependencies (Ubuntu/Debian)
sudo apt update
sudo apt install -y libwebkit2gtk-4.1-dev build-essential curl wget libssl-dev libgtk-3-dev libayatana-appindicator3-dev librsvg2-dev

# Install Node.js
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

# Install pnpm
npm install -g pnpm

# Install Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Install Tauri CLI
cargo install tauri-cli

‍

Windows

# Install via winget or download manually:
# 1. Node.js: https://nodejs.org/ (v18+)
# 2. pnpm: npm install -g pnpm
# 3. Rust: https://rustup.rs/
# 4. Visual Studio Build Tools with C++ workload
# 5. Tauri CLI: cargo install tauri-cli

‍

Build Steps

# Clone the repository
git clone https://github.com/kuse-ai/kuse_cowork.git
cd kuse_cowork

# Install dependencies
pnpm install

# Development mode
pnpm tauri dev

# Build for production
pnpm tauri build

The built application will be in src-tauri/target/release/bundle/.

‍

Docker Setup

Kuse Cowork uses Docker for secure command execution. Make sure Docker is installed and running:

macOS

# Download Docker Desktop from https://www.docker.com/products/docker-desktop
# Start Docker Desktop
# Verify installation:
docker run hello-world

‍

Linux

# Install Docker Engine
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

# Add user to docker group
sudo usermod -aG docker $USER
newgrp docker

# Verify installation
docker run hello-world

‍

Windows

# Download Docker Desktop from https://www.docker.com/products/docker-desktop
# Enable WSL 2 backend (recommended)
# Start Docker Desktop
# Verify installation:
docker run hello-world

‍

Verifying Installation

After installation, launch Kuse Cowork and verify:

1. The application opens without errors
2. Docker status shows "Connected" in settings
3. You can configure at least one AI provider

Troubleshooting

Application won't start on macOS

If you see "App is damaged and can't be opened", run:

xattr -cr /Applications/Kuse_Cowork.app

Docker connection failed

1. Ensure Docker Desktop is running
2. Check Docker socket permissions (Linux): sudo chmod 666 /var/run/docker.sock
3. Restart Kuse Cowork

Build fails on Windows

Ensure Visual Studio Build Tools are installed with "C++ build tools" workload.

Next Steps

• Quick Start Guide - Get started with your first task
• Configuration - Configure API keys and settings

‍