Installation
QUANTAXIS 安装：pip 与 Docker 下载部署教程
QUANTAXIS 官方提供源码安装（git clone + pip install -e .）与容器化部署（Docker/Kubernetes）两条主路径。安装前需要 Python 3.9-3.12（推荐 3.11+）与 MongoDB 4.0+。下面是官方安装方式的落地说明。
源码安装pip install -e .
可选组件[rust]/[full]
容器部署Docker/K8s
前置MongoDB 4.0+
Step by step
源码安装步骤
适用于有 Python 环境的开发者；命令来自官方 README。
准备环境
安装 Python 3.9-3.12（推荐 3.11+）与 MongoDB 4.0+；如需 Rust 组件需先安装 Rust 工具链。
克隆仓库
git clone https://github.com/yutiansut/QUANTAXIS.git，进入项目目录。
基础安装
pip install -e . 完成基础安装。
可选组件安装
按需 pip install -e .[rust]（Rust 组件）、.[performance]（性能优化）、.[full]（完整安装）。
git clone https://github.com/yutiansut/QUANTAXIS.git
cd QUANTAXIS
pip install -e . # 基础
pip install -e .[rust] # 含 Rust 组件（推荐）
pip install -e .[performance] # 性能优化
pip install -e .[full] # 完整前置披露：上述命令来自官方 README；实际安装可能因操作系统、Python 版本与网络环境而异，本站不承诺一次成功。
Alternative
容器化部署（Docker / Kubernetes）
官方提供 Docker 与 Kubernetes 部署指南，适合不想手动配环境的用户，但仍需自己维护容器与数据卷。
| 部署方式 | 适合场景 | 前置 |
|---|---|---|
| 源码 pip 安装 | 本地开发、单机研究 | Python 3.9-3.12 + MongoDB |
| Docker | 隔离环境、快速起服务 | Docker 运行时 |
| Kubernetes | 分布式、生产化部署 | K8s 集群 |
Verify
安装后如何验证
装完后按下面几项快速确认环境是否就绪，避免进入首次运行时报错。
| 检查项 | 验证方式 |
|---|---|
| Python 版本 | python --version，需 3.9-3.12（推荐 3.11+） |
| MongoDB 服务 | 确认 MongoDB 4.0+ 已启动并可连接 |
| QUANTAXIS 导入 | python -c "import QUANTAXIS" 无报错 |
| Rust 组件（可选） | 仅安装 [rust]/[full] 时确认 Rust 工具链可用 |
下一步：验证通过后进入 首次运行页 准备数据并启动账户体系。
FAQ
安装常见问题
QUANTAXIS 安装失败怎么办？
先检查 Python 版本（需 3.9-3.12）、MongoDB 是否启动、Rust 组件是否需要工具链；官方文档中心（./doc/README.md）与 GitHub Issues 是主要排查入口。
必须装 Rust 组件吗？
不是。基础安装 pip install -e . 即可，Rust 组件（[rust]/[full]）用于高性能回测与账户，按需安装。
能不能不配环境直接用？
QUANTAXIS 是纯本地框架，需自行配置 Python/MongoDB 环境；若想免部署做量化研究，可看 EasyClaw 量化 Skill 路线（两者无已证实集成）。