rexprun 0.2.1__tar.gz → 0.2.2__tar.gz

{rexprun-0.2.1 → rexprun-0.2.2}/MANIFEST.in

@@ -6,5 +6,6 @@ exclude .agents
 
 # Exclude caches and build leftovers from sdists
 global-exclude __pycache__ *.py[cod]
+global-exclude .DS_Store
 recursive-exclude * __pycache__
 exclude HANDOFF.md

{rexprun-0.2.1/rexprun.egg-info → rexprun-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rexprun
-Version: 0.2.1
+Version: 0.2.2
 Summary: Research experiment orchestration with resource-aware scheduling, isolated environments, checkpoint recovery, and Ray Tune searches on GPUs and Ascend NPUs.
 Author: REXP contributors
 License: MIT

{rexprun-0.2.1 → rexprun-0.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "rexprun"
-version = "0.2.1"
+version = "0.2.2"
 description = "Research experiment orchestration with resource-aware scheduling, isolated environments, checkpoint recovery, and Ray Tune searches on GPUs and Ascend NPUs."
 readme = "README.md"
 requires-python = ">=3.10"

{rexprun-0.2.1 → rexprun-0.2.2}/rexp/docs//344/275/277/347/224/250/350/257/264/346/230/216/344/271/246.md

@@ -51,6 +51,10 @@ Windows 安装后的命令通常是 `<Conda环境>\Scripts\rexp.exe`。
 其他实验环境用 `rexp node env create NAME --python 3.11 --description "中文用途及限制"` 创建、登记在 `<根目录>/env/NAME`；uv/Conda 可按版本创建，venv 需要已安装的 Python 可执行文件（可用 `--python /path/to/python`）。优先复用已有兼容环境；云镜像的 TorchNPU/CANN 环境也可用 `node env add --python` 登记，不重装驱动。Conda prefix 环境与 uv/venv 一样由平台记录绝对解释器路径；既有 Conda 命名环境继续支持 `--conda-env` 登记。`env/platform` 保留给平台，不能登记为普通实验环境。
 
 环境设置失败保留数据根目录，修复原因后重跑相同 init。依赖下载失败但解释器已建好时可重试安装；解释器创建中断留下不完整目录时会提示先检查，不自动删除。首次初始化保存用户默认根目录；已有默认根目录时用 `--save-default` 显式切换。安装后分别检查插件内和不设置 PLATFORM_ROOT 的普通终端 `rexp doctor --json`，确认根目录、绑定管理器、平台解释器及 default 环境一致。
+
+Agent 首次询问管理器时应给出完整三项：安装 uv（推荐）、安装 Conda、使用现有 Python venv（不安装管理器）。推荐 uv 不会移除 Conda 选项。环境创建/安装显示当前步骤；pip/uv 默认每次网络请求超时 15 秒、重试一次，用户显式配置优先，整个初始化仍有独立总时限。
+
+离线安装先准备匹配远端 OS/架构/Python ABI 的完整 wheelhouse，然后设置 `UV_OFFLINE=true UV_FIND_LINKS=<目录> PIP_NO_INDEX=1 PIP_FIND_LINKS=<目录>` 执行相同 init。`uv venv --seed` 也需要种子包（所选 Python 所需的 pip/setuptools/wheel）；集合应另包含 default 的 NumPy 等依赖。仅设置 `UV_NO_INDEX=1` 不能让 uv 离线。已有 wheelhouse 时直接离线使用；失败后检查环境，不重复长时间联网尝试。
 `rexp doctor --json` 与 `rexp platform info --json` 的 `experiment_setup` 返回登记状态：
 `needs_environment` 表示没有实验环境，`registered` 只代表已登记，实际实验仍须检查项目依赖。
 至少登记一个可用实验环境；未登记名为 `default` 的环境时，在实验 YAML 中显式指定 `environment:`，

{rexprun-0.2.1 → rexprun-0.2.2}/rexp/server/environments.py

@@ -41,7 +41,21 @@ def select_manager(available, requested="auto", existing=None):
 
 
 def run(command, timeout=900):
-    result = subprocess.run([str(x) for x in command], capture_output=True, text=True, timeout=timeout)
+    # A failed index request should not consume pip/uv's long default retries.
+    # Explicit operator settings (including offline wheelhouses) still win.
+    child_env = os.environ.copy()
+    for key, value in {"PIP_DEFAULT_TIMEOUT": "15", "PIP_RETRIES": "1",
+                       "PIP_DISABLE_PIP_VERSION_CHECK": "1",
+                       "UV_HTTP_TIMEOUT": "15", "UV_HTTP_RETRIES": "1"}.items():
+        child_env.setdefault(key, value)
+    argv = [str(x) for x in command]
+    print(f"Environment step: {Path(argv[0]).name} {' '.join(argv[1:3])}", flush=True)
+    try:
+        result = subprocess.run(argv, capture_output=True, text=True, timeout=timeout, env=child_env)
+    except subprocess.TimeoutExpired as exc:
+        raise RuntimeError(f"Environment step timed out after {timeout}s. Inspect the existing environment before retrying; "
+                           "for a prepared wheelhouse use UV_OFFLINE=true UV_FIND_LINKS=<directory> "
+                           "and PIP_NO_INDEX=1 PIP_FIND_LINKS=<directory>.") from exc
     if result.returncode:
         raise RuntimeError(f"Environment command failed: {(result.stderr or result.stdout)[-1500:]}")
     return result.stdout

{rexprun-0.2.1 → rexprun-0.2.2}/rexp/skills/platform-operations/SKILL.md

@@ -61,6 +61,12 @@ REXP = Research Experiment Platform：单节点、离线优先的个人科研实
 用途自行选择，并告知实际位置。已有平台根目录优先保留，不在源码、cache 或临时目录下另起安装。
 `rexp init` 会检测 Conda 与 uv：首次配置时两者都有优先 uv，只有一个则绑定该管理器。都没有时交互询问是否安装 uv/Conda；选择不安装则使用 Python venv。`--yes` 不擅自安装管理器，缺少管理器时使用 venv；Agent 应先询问用户，再通过 `--install-manager uv|conda` 明确表达安装授权，也可用 `--env-manager uv|conda|venv` 指定已安装的管理器。已绑定的管理器保留，除非显式切换。
 
+Agent 提问时必须完整列出：**安装 uv（推荐）／安装 Conda／使用现有 Python venv、不安装管理器**。推荐顺序不能成为省略 Conda 的理由；仅在目标系统/架构确实不支持时说明限制。探测常见安装位置，不能只凭非登录 shell 的 `command -v` 就断言不存在。确认目录与选择后按插件清单安装，不反复遍历本机配置、技能或读取平台源码。
+
+下载失败时先说明失败阶段、耗时和下一步，检查已有进程/环境后再重试。初始化的 pip/uv 网络默认超时 15 秒、重试一次，保留用户显式配置；这不是整个初始化过程的总时限。来源已确认不可达时，不重复发起长时间在线安装；可使用用户认可的依赖镜像，或控制端准备匹配远端 OS/架构/Python ABI 的官方 wheel。
+
+离线 wheelhouse 同时设置 `UV_OFFLINE=true UV_FIND_LINKS=<目录>` 与 `PIP_NO_INDEX=1 PIP_FIND_LINKS=<目录>`，再执行原 init。`UV_NO_INDEX=1` 不能替代 `UV_OFFLINE=true`；`uv venv --seed` 也会获取种子包，所以集合需包含所选 Python 版本所需的 pip/setuptools/wheel 及 default 的 NumPy、PyYAML、pydantic、packaging 等完整依赖。已有 wheelhouse 时直接离线安装，不再发起在线安装试探；保留 SSH 长连接，不为初始化重启 MCP/Web。
+
 平台复用现有独立运行环境；从系统 Python 或 Conda base 初始化时准备 `<根目录>/env/platform` 并安装平台，原全局 `rexp` 命令会转交给已配置的平台 Python。平台无需 PyTorch，不安装科研依赖。默认实验环境为 `<根目录>/env/default`，登记为 `default`，安装 NumPy、PyYAML、pydantic、packaging 等轻量分析/runner 依赖。已有 default 保留并检查解释器存在；不自动启动调度器。`--skip-default-env` 仅初始化存储，跳过全部环境准备。
 
 其他实验环境用 `rexp node env create NAME --python 3.11 --description "中文用途及限制"` 创建、登记在 `<根目录>/env/NAME`；uv/Conda 可按版本创建，venv 需要已安装的 Python 可执行文件（可用 `--python /path/to/python`）。优先复用已有兼容环境；云镜像的 TorchNPU/CANN 环境也可用 `node env add --python` 登记，不重装驱动。Conda prefix 环境与 uv/venv 一样由平台记录绝对解释器路径；既有 Conda 命名环境继续支持 `--conda-env` 登记。`env/platform` 保留给平台，不能登记为普通实验环境。

rexprun-0.2.2/rexp/version.py

@@ -0,0 +1 @@
+__version__ = "0.2.2"

{rexprun-0.2.1 → rexprun-0.2.2/rexprun.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rexprun
-Version: 0.2.1
+Version: 0.2.2
 Summary: Research experiment orchestration with resource-aware scheduling, isolated environments, checkpoint recovery, and Ray Tune searches on GPUs and Ascend NPUs.
 Author: REXP contributors
 License: MIT

{rexprun-0.2.1 → rexprun-0.2.2}/tests/test_environment_setup.py

@@ -50,6 +50,24 @@ class TestEnvironmentSetup(unittest.TestCase):
         with self.assertRaises(ValueError):
             env.select_manager({}, 'invalid')
 
+    def test_install_network_limits_preserve_offline_and_user_settings(self):
+        with mock.patch.dict(os.environ, {'UV_OFFLINE': 'true', 'UV_FIND_LINKS': '/wheels',
+                'PIP_NO_INDEX': '1', 'PIP_FIND_LINKS': '/wheels', 'UV_HTTP_TIMEOUT': '45'}, clear=True), \
+                mock.patch.object(env.subprocess, 'run', return_value=subprocess.CompletedProcess([], 0, 'ready', '')) as run:
+            self.assertEqual(env.run(['/uv', 'pip', 'install']), 'ready')
+        inherited = run.call_args.kwargs['env']
+        self.assertEqual(inherited['UV_HTTP_TIMEOUT'], '45')
+        self.assertEqual(inherited['UV_HTTP_RETRIES'], '1')
+        self.assertEqual(inherited['PIP_DEFAULT_TIMEOUT'], '15')
+        self.assertEqual(inherited['PIP_RETRIES'], '1')
+        for key in ('UV_OFFLINE', 'UV_FIND_LINKS', 'PIP_NO_INDEX', 'PIP_FIND_LINKS'):
+            self.assertIn(key, inherited)
+
+    def test_environment_timeout_has_repair_guidance(self):
+        with mock.patch.object(env.subprocess, 'run', side_effect=subprocess.TimeoutExpired(['uv'], 10)):
+            with self.assertRaisesRegex(RuntimeError, 'UV_OFFLINE=true'):
+                env.run(['/uv', 'venv'], timeout=10)
+
     def test_existing_binding_is_stable(self):
         manager = self.bind()
         self.assertEqual(env.select_manager({'uv': '/uv'}, existing=manager), manager)

rexprun-0.2.1/rexp/version.py

@@ -1 +0,0 @@
-__version__ = "0.2.1"