安装与许可证¶

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

安装 Python 包¶

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 启用离线许可证校验。先在实际运行机器生成申请文件：

optagent-license request --output optagent-license-request.json

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

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

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

确认环境¶

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

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