跳到主要内容

安装

NautilusTrader 官方支持在以下 64 位平台上使用 Python 3.11-3.13：

操作系统支持版本CPU 架构
Linux (Ubuntu)22.04 及更高版本x86_64
Linux (Ubuntu)22.04 及更高版本ARM64
macOS14.7 及更高版本ARM64
Windows Server2022 及更高版本x86_64
备注

NautilusTrader 可能在其他平台上工作，但只有上述列出的平台会被开发者定期使用并在 CI 中测试。

我们建议使用最新支持的 Python 版本，并在虚拟环境中安装 nautilus_trader 以隔离依赖项。

有两种支持的安装方式：

  1. 从 PyPI 或 Nautech Systems 包索引安装预构建的二进制 wheel
  2. 从源代码构建
提示

我们强烈建议使用 uv 包管理器和"原版" CPython 进行安装。

Conda 和其他 Python 发行版可能可以工作，但不受官方支持。

从 PyPI 安装​

使用 Python 的 pip 包管理器从 PyPI 安装最新的 nautilus_trader 二进制 wheel（或 sdist 包）：

pip install -U nautilus_trader

额外依赖​

为特定集成安装可选依赖作为"额外"组件：

  • betfair: Betfair 适配器（集成）依赖项
  • docker: 使用 IB 网关时需要 Docker（与 Interactive Brokers 适配器一起使用）
  • dydx: dYdX 适配器（集成）依赖项
  • ib: Interactive Brokers 适配器（集成）依赖项
  • polymarket: Polymarket 适配器（集成）依赖项

使用 pip 安装特定的额外依赖：

pip install -U "nautilus_trader[docker,ib]"

从 Nautech Systems 包索引安装​

Nautech Systems 包索引（packages.nautechsystems.io）符合 PEP-503 标准，托管 nautilus_trader 的稳定版和开发版二进制 wheel。 这使用户能够安装最新的稳定发布版本或预发布版本进行测试。

稳定版 wheel​

稳定版 wheel 对应 nautilus_trader 在 PyPI 上的官方发布版本，使用标准版本号。

安装最新稳定发布版本：

pip install -U nautilus_trader --index-url=https://packages.nautechsystems.io/simple

开发版 wheel​

开发版 wheel 从 nightly 和 develop 分支发布， 允许用户在稳定发布之前测试功能和修复。

注意：来自 develop 分支的 wheel 仅为 Linux x86_64 平台构建以节省时间和计算资源， 而 nightly wheel 支持如下所示的其他平台。

平台NightlyDevelop
Linux (x86_64)✓✓
Linux (ARM64)✓-
macOS (ARM64)✓-
Windows (x86_64)✓-

此过程还有助于保护计算资源，确保轻松访问在 CI 管道中测试的确切二进制文件， 同时遵循 PEP-440 版本标准：

  • develop wheel 使用版本格式 dev{date}+{build_number}（例如，1.208.0.dev20241212+7001）
  • nightly wheel 使用版本格式 a{date}（alpha）（例如，1.208.0a20241212）
注意

我们不建议在生产环境中使用开发版 wheel，例如控制真实资本的实时交易。

安装命令​

默认情况下，pip 将安装最新的稳定发布版本。添加 --pre 标志确保考虑预发布版本，包括开发版 wheel。

安装最新可用的预发布版本（包括开发版 wheel）：

pip install -U nautilus_trader --pre --index-url=https://packages.nautechsystems.io/simple

要安装特定的开发版本，请指定确切的版本：

pip install -U nautilus_trader==1.208.0.dev20241212+7001 --index-url=https://packages.nautechsystems.io/simple

从源代码构建​

从源代码构建 NautilusTrader 需要更多的设置和依赖项，但提供了最大的灵活性。

系统要求​

  • Python: 3.11-3.13
  • Rust: 最新稳定版本
  • C++ 编译器: GCC 或 Clang
  • 构建工具: Make, CMake

克隆仓库​

git clone https://github.com/nautechsystems/nautilus_trader.git
cd nautilus_trader

安装构建依赖​

pip install -r requirements-build.txt

构建和安装​

pip install -e .

验证安装​

验证 NautilusTrader 是否正确安装：

import nautilus_trader

print(nautilus_trader.__version__)

故障排除​

常见问题​

  1. Python 版本不兼容: 确保使用 Python 3.11-3.13
  2. 依赖冲突: 使用虚拟环境隔离依赖项
  3. 编译错误: 确保安装了必要的构建工具

获取帮助​

如果遇到安装问题：

下一步​

安装完成后，请查看：

最后由 huojiabin 于 更新