用途:为 HuggingFace 持久化做一次性初始化,适用于新项目接入或凭据变更时运行。
主要能力:校验必需的 .env 变量是否设置;用配置的 token 测试 API 连通性;确保 HF Hub 上数据集仓库存在;创建标准目录结构(lineage/、data/、metadata/);上传带可配置发现标签的数据集卡片(README.md)。
依赖:需要 Python 3.8+,仅用标准库,无外部包。安装依赖命令:pip-compile ./requirements.in 与 pip install -r ./requirements.txt(requirements.txt 当前为空)。
环境变量:HUGGING_FACE_USERNAME(必需)、HUGGING_FACE_TOKEN(必需,设置在 ~/.zshrc,不要放 .env)、HUGGING_FACE_REPO(必需)、HUGGING_FACE_DATASET_PATH(必需)、HUGGING_FACE_TAGS(可选,逗号分隔的发现标签)、HUGGING_FACE_PROJECT_NAME(可选,数据集卡片标题名)、SOUL_VALENCE_THRESHOLD(可选,道德/情绪过滤,默认 -0.7)。
用法:校验配置运行 python ./hf_config.py;完整初始化(校验+创建结构+数据集卡片)运行 python ./hf_init.py;仅校验不改动运行 python ./hf_init.py --validate-only。快速设置:在 shell 配置中 export HUGGING_FACE_TOKEN=hf_xxxxxxxxxxxxx,在 .env 中设置项目变量,可选自定义标签与项目名,然后运行 python ./hf_init.py。
限制:资料未提供更多平台支持、错误处理细节或收费信息。