インストール

使い方に合う経路を選んでください。ほとんどの利用者にはデスクトップアプリが最も簡単です。より細かく管理したい場合は、ブラウザ、ターミナル、Docker も利用できます。

デスクトップアプリ

デスクトップアプリは Agent、Web UI、自動更新を 1 つのインストーラーにまとめています。Node.js、ビルドツールチェーン、ターミナルは不要です。

プラットフォーム	対応パッケージ	ダウンロード
macOS（Apple Silicon）	`.dmg`	GitHub Releases
Windows（x64）	インストーラー	GitHub Releases
Linux（x64）	AppImage または `.deb`	GitHub Releases

リリースページで環境に合うパッケージを取得し、インストール後にログインして会話を始めてください。リリースノートには現在のビルド、署名状態、既知の問題が記載されます。

ブラウザとコマンドライン

ブラウザで Web UI を使う、またはターミナル中心で使う場合はインストーラーを利用します。

curl -fsSL https://raw.githubusercontent.com/minara-ai/minara-agent/main/scripts/install.sh | bash

インストーラーは Linux、macOS、WSL2、Termux 経由の Android に対応します。Node.js とローカルデータベースに必要なネイティブビルドツールを確認し、Minara をインストールしてセットアップを開始します。

Windows： デスクトップインストーラーを使うか、WSL2 をインストールしてから上記コマンドを実行してください。ネイティブ Windows shell でのインストールはサポートしていません。

ネイティブ Windows での違い

デスクトップインストーラーは agent を同梱してネイティブ Windows 上で実行します。そのため Windows でのサポート対象はデスクトップアプリです。ネイティブ Windows に対応していないのは、上記の shell インストーラーの方です。

会話、リサーチ、マーケットデータ、取引、オートメーション、Web UI はどのプラットフォームでも同じように動作します。以下の機能は異なります。

機能	ネイティブ Windows	macOS · Linux · WSL2
ターミナルツール	`cmd.exe` 経由で実行	`/bin/sh` 経由で実行
スキルの補助スクリプト	POSIX 前提のスクリプト（`.sh`、`jq`）は動作しません	利用可能
コーディングのプロジェクト操作（install / build / test）	利用不可（OS のファイルシステム jail が必要）	利用可能（Linux は bubblewrap、macOS は sandbox-exec）
構造化 Git と Git over SSH	利用不可	利用可能
サブプロセスの分離	コマンドガードのみ	コマンドガードと OS のファイルシステム jail

利用不可と記載された機能が必要な場合は、WSL2 上で Minara を実行してください。

インストール後：

source ~/.zshrc             # または: source ~/.bashrc
minara setup                # Minara と LLM provider を接続
minara serve --ui           # http://localhost:4173 で Web UI を開く
minara                      # またはターミナルで会話を開始

ソースからインストール

Minara を開発する、または checkout を自分で管理する場合は次を実行します。

git clone https://github.com/Minara-AI/minara-agent.git
cd minara-agent
corepack enable
pnpm install
pnpm dev

Node.js 24 以降と pnpm 9.15.0 が必要です。macOS では Xcode Command Line Tools、Debian または Ubuntu では better-sqlite3 をビルドするために build-essential が必要です。

インストーラー経由の checkout は minara update で更新できます。ソース checkout は最新変更を pull してから pnpm install を再実行してください。

Docker

Docker は Web UI と gateway をまとめて起動します。

pnpm docker

初回実行ではサンプルから .env を作成して停止するため、認証情報を入力できます。もう一度実行するとビルドして起動します。永続データ、アップグレード、ネットワーク公開、Agent 専用コンテナはデプロイを参照してください。

セットアップを確認する

minara doctor
minara doctor --probe-llm

チェックが通れば準備完了です。最初の取引から始めるか、Web UI を探索してください。