# 安装与许可证

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

## 安装 Python 包

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

需要 CP-SAT 或 MathOpt 时，安装 OR-Tools extra：

```bash
python -m pip install "optagent[ortools]"
```

`solve()` 与 `solve_optx()` 使用包内原生内核；安装 OR-Tools 不会替代该内核。若提示没有匹配的发行包，先核对 Python 版本、平台和发行渠道提供的 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。