安装指南

本页说明 OptAgent wheel 安装包的适用环境、获取方式与安装步骤。

支持的环境

• Linux
• macOS
• Windows

Python 环境要求

• Python 3.9 及更高版本
• 页面中的命令示例默认使用当前虚拟环境的 Python 作为演示基线
• 建议使用独立虚拟环境安装

支持的安装工具

• pip
• uv

安装包获取

OptAgent 当前发布形式为 wheel 文件。

如需安装包，请联系项目经理获取当前版本的 .whl 文件。

安装步骤

1. 确认当前操作系统为 Linux、macOS 或 Windows，且本机 Python 版本为 3.9 或更高版本。
2. 联系项目经理获取当前发布的 wheel 文件，例如 optagent-0.2-py3-none-any.whl。
3. 在目标环境中准备 Python 虚拟环境。
4. 使用 pip 或 uv 安装 wheel 文件。

使用 pip 安装

# 1. 使用当前 Python 环境的 pip 安装本地 wheel 文件。
python -m pip install /path/to/optagent-0.2-py3-none-any.whl

使用 uv 安装

# 1. 使用 uv 管理的 Python 环境安装同一个本地 wheel 文件。
uv pip install /path/to/optagent-0.2-py3-none-any.whl

额外依赖安装

如果需要安装带额外依赖的本地 wheel，可使用 extras 形式安装：

# 1. 安装 OR-Tools 相关额外依赖，适合 CP-SAT 路径。
python -m pip install '/path/to/optagent-0.2-py3-none-any.whl[ortools]'

# 2. 安装 HiGHS 相关额外依赖，适合 HiGHS 原生 MILP 路径。
python -m pip install '/path/to/optagent-0.2-py3-none-any.whl[highs]'

# 3. 同时安装 OR-Tools 和 HiGHS 额外依赖。
python -m pip install '/path/to/optagent-0.2-py3-none-any.whl[ortools,highs]'

安装后验证

安装完成后，可执行以下命令确认包已成功安装：

# 1. 导入 optagent 并打印包路径，确认当前环境能找到安装后的包。
python -c "import optagent; print(optagent.__file__)"

说明

• pip 与 uv 都支持从本地 wheel 文件安装。
• 安装命令适用于 Python 3.9 及更高版本。
• 上方 Wheel Python Matrix 展示的是当前 wheel 已验证的 Python 版本范围。
• 请优先使用项目经理提供的最新版 wheel 文件。