# vrp-cli

**Repository Path**: wcyl/vrp-cli

## Basic Information

- **Project Name**: vrp-cli
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-18
- **Last Updated**: 2025-12-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# vrcli：VideoRoPE 复现助手（交互式中文 CLI）

这是一个**独立小项目**（放在仓库根目录下的 `vrcli/`），提供统一入口，进入后按菜单操作：
- 环境检测（逐项检查 + 修复提示）
- Hugging Face 下载（模型/数据集）
- 数据集准备（解包/软链接到 `VideoRoPE-main` 期望结构）
- V-NIAH-D 核心实验（生成 haystack → 生成 embeddings → 跑对比实验）

## 运行方式

1) 直接运行模块（无需安装）：
```bash
python -m vrcli
```

2) 安装成命令（推荐）：
```bash
pip install -e vrcli
vrcli
```

## 依赖说明

本项目自身依赖尽量少；但你要跑不同功能，需要对应环境：
- 下载优先级：**ModelScope 优先，失败自动降级 HF-Mirror(hfd)**  
  - ModelScope：`pip install modelscope`
  - HF-Mirror(hfd)：需要 `curl` + `aria2c`，并会自动下载 `hfd.sh`
- 可选：`pip install datasets`（Video-MME 的 TSV 生成会用到）
- V-NIAH-D：`torch transformers accelerate deepspeed pillow ffmpeg`
- 下游评测：还可能需要 `qwen_vl_utils`（仓库 `eval/` 依赖）

建议先在菜单里跑“环境检测”，按提示补齐。

## 目录名兼容
`vrcli` 支持你的仓库目录名是 `VideoRoPE/` 或 `VideoRoPE-main/`（会自动检测）。