安装与许可证¶

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

安装 Python 包¶

python -m pip install optagent

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

python -m pip install "optagent[ortools]"

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