# 安装与许可证

OptAgent 支持 Python 3.9–3.14。使用与目标平台和 Python 版本匹配的发布 wheel。

## 安装 Python 包

```bash
python -m pip install optagent
```

`solve()`、`solve_heuristic()` 和 `solve_optx()` 的求解能力均随包提供。
精确求解的 HiGHS 和 OR-Tools CP-SAT 后端均已内置，无须另装 Python `ortools` 或 `highspy`。
OptAgent 本身也不要求安装 NumPy 或 Pandas；运行 Notebook 示例时，按案例说明准备数据处理和交互环境。
若提示没有匹配的发行包，先核对 Python 版本、平台和发行渠道提供的 wheel。
从源码构建需要支持 C++20 的 C++ 工具链；安装匹配的 wheel 无须本机编译器。

## 配置离线许可证

发布 wheel 启用离线许可证校验。先在实际运行机器生成申请文件：

```bash
optagent-license request --output optagent-license-request.json
```

将申请文件交给许可证签发方，取得匹配当前机器的许可证后安装并检查状态：

```bash
optagent-license install /path/to/license.json
optagent-license status
```

命令默认安装到当前用户范围。申请文件已存在时默认不覆盖。内核拒绝许可证时，Python 求解入口抛出 `LicenseError`。

## 确认环境

```bash
python -c "from importlib.metadata import version; from optagent import OptModel; print(version('optagent'))"
```

成功导入只确认 Python 包可用；请继续执行[第一个模型](quickstart.md)，验证原生求解与许可证。文档顶部显示当前文档版本，开发版内容可能领先于已发布 wheel。