DORO-STVG

Installation

1. Install uv

curl -LsSf https://astral.sh/uv/install.sh | sh
source ~/.bashrc

2. Create virtual environment

Choose your environment path and create it:

bash ./scripts/setup_env.sh ~/.virtualenvs/stvg/dev

3. Activate environment

source scripts/activate_env.sh ~/.virtualenvs/stvg/dev

4. Install package

# install eval
cd eval
uv sync --active

# install graph_generator
cd graph_generator
uv sync --active

5. Configuration for video processing

Set the video reader backend by exporting the environment variable:

# Use torchvision (default)
export FORCE_QWENVL_VIDEO_READER=torchvision

# Or use decord (recommend)
export FORCE_QWENVL_VIDEO_READER=decord

# Or use torchcodec
export FORCE_QWENVL_VIDEO_READER=torchcodec

6. Add and remove dependencies

# Add a new package
uv add --active [package-name]

# Remove a package
uv remove --active [package-name]

7. Deactivate environment

deactivate

8. Switch to different environment

# Deactivate current environment
deactivate

# Activate another environment
source scripts/activate_env.sh /path/to/another/env

Quick Start

# run eval
cd eval
bash run_eval.sh

# run graph_generator
cd graph_generator
bash run_generator.sh