Valohai本地执行Python脚本时valohai.inputs返回None的问题咨询

核心原因 #

直接用python script.py本地执行时，valohai-utils不会自动加载valohai.yaml的配置，也不会触发输入文件的下载/映射逻辑，只有通过Valohai官方的本地运行命令启动，才能激活它的本地模式。

解决步骤 #

• 用valohai run启动脚本
  不要直接运行Python脚本，而是在本地虚拟环境中执行：

  valohai run my_step --adhoc
  

  这个命令会读取valohai.yaml中my_step的配置，自动处理输入文件的下载或本地映射，确保valohai.inputs('dataset').path()能返回正确的文件路径。

• 检查valohai.yaml的输入配置
  确认你的valohai.yaml中，my_step对应的inputs字段已正确定义dataset，并且可以指定默认源方便本地测试，比如：

  steps:
    my_step:
      command: python script.py
      inputs:
        dataset:
          default: s3://my-bucket/dataset.csv  # 或者本地路径 ./local-test-data.csv
          description: Input dataset file
  

• 手动指定本地输入（可选）
  如果需要临时替换输入源，运行时可以通过--input参数指定：

  valohai run my_step --adhoc --input dataset=./local-test-data.csv
  

• 确保valohai-utils版本正确
  升级到最新版的valohai-utils，避免版本兼容问题：

  pip install --upgrade valohai-utils
  

临时兜底方案（不推荐长期使用） #

如果需要偶尔直接用python script.py测试，可以在脚本中添加检测逻辑：

import valohai

input_path = valohai.inputs('dataset').path()
if not input_path:
    # 本地测试用的默认路径
    input_path = "./local-test-data.csv"

内容的提问来源于stack exchange，提问作者Christian