ソースからビルドする¶

ビルド済みリリースを使わずにローカルで Koharu をコンパイルしたい場合は、まずリポジトリの Bun ラッパーを使ってください。これは通常の開発フローに合わせた経路で、Tauri を直接呼ぶだけでは拾えないプラットフォーム固有のセットアップも処理します。

ビルドに含まれるもの¶

デスクトップ向けのフルビルドには次が含まれます。

既定のデスクトップビルドはプラットフォームを見て機能を切り替えます。

Windows でソースビルドする場合は、次も必要です。

リポジトリ内の scripts/dev.ts ヘルパーは、Windows 上で Tauri を起動する前に nvcc と cl.exe を自動検出しようとします。

bun install

bun run build

これが通常ユーザー向けのソースビルド経路です。リポジトリの Bun ヘルパーが実行され、プロジェクトで想定しているビルドフローで Tauri を起動します。

Windows では、このラッパーがビルド開始前に nvcc と cl.exe の自動検出も試みます。

主なバイナリは target/release に出力されます。

リリース向けバイナリを作るのではなく、アプリを継続的に開発する場合は次を使います。

bun run dev

この dev スクリプトは tauri dev を起動し、デスクトップシェルと UI が同じランタイムと通信できるように、ローカルサーバーを固定ポートで立ち上げます。

Bun ラッパーを経由せずに Tauri の呼び出しを自分で制御したい場合は、次を使ってください。

bun tauri build --release --no-bundle

これはより素の Tauri コマンドに近く、ビルド呼び出しを明示的に制御したい場合に便利です。

bun run build と違って、この経路では Windows 向けの CUDA / Visual Studio 設定ヘルパーを経由しません。

Bun と Tauri のラッパーを意図的に迂回し、Rust クレートだけを直接ビルドしたい場合は、cargo をそのまま呼ぶのではなく bun cargo を使ってください。

例:

# Windows / Linux
bun cargo build --release -p koharu --features=cuda

# macOS Apple Silicon
bun cargo build --release -p koharu --features=metal

これは低レベルな Rust 作業には便利ですが、通常のデスクトップアプリビルドとしては、Tauri のフルフローを保てる bun run build のほうが適しています。

アプリをビルドしても、すべてのモデル重みが同梱されるわけではありません。初回起動時には、Koharu はまだ次を行う必要があります。

アプリを立ち上げずにこれらの依存物だけ先に取得したい場合は、GUI / Headless / MCP モードを使うを参照してください。