安装

选择适合你的使用方式。大多数用户最适合桌面端；如果你需要更多控制，也可以使用浏览器、终端或 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。