安裝

選擇適合你的使用方式。大多數用戶最適合桌面端；如果你需要更多控制，也可以使用瀏覽器、終端或 Docker。

桌面端

桌面端將 Agent、Web UI 和自動更新打包到一個安裝程序中。不需要 Node.js、編譯工具鏈或終端。

打開發布頁，下載對應平臺的安裝包，完成安裝後登錄即可開始對話。發佈說明會列出當前版本、簽名狀態和已知問題。

瀏覽器和命令行

如果想在瀏覽器中使用 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 在所有平臺上表現一致。以下能力則不同：

如果你需要表中標為不可用的能力，請在 WSL2 下運行 Minara。

安裝後：

source ~/.zshrc             # 或：source ~/.bashrc
minara setup                # 連接 Minara 和 LLM provider
minara serve --ui           # 在 http://localhost:4173 開啟 Web UI
minara                      # 或啟動終端對話

登錄

Minara 需要 Minara 賬戶來提供行情和交易服務，也需要一個 LLM provider 來推理。配置嚮導可以完成兩者，也可以直接登錄：

minara auth login minara
minara auth login openai    # 也可使用 anthropic、openrouter、xai 和其他支持的 provider

Provider 選擇見LLM Providers，密鑰配置見環境變量。

從源碼安裝

如果想開發 Minara 或自行管理代碼倉庫，請使用源碼安裝：

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 需要 build-essential 來構建 better-sqlite3。

安裝腳本安裝的版本可用 minara update 更新。源碼安裝則拉取最新代碼後重新運行 pnpm install。

Docker

Docker 會一起啟動 Web UI 和網關：

pnpm docker

首次運行會從示例創建 .env 並停止，供你填寫憑據。再次運行即可構建並啟動。持久化數據、升級、網絡暴露和僅 Agent 容器見部署。

檢查配置

minara doctor
minara doctor --probe-llm

檢查通過後即可開始使用。可以從首次交易開始，或直接探索 Web UI。