CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Video Model Studio - Guidelines for Claude

Build & Run Commands

• Setup: ./setup.sh (with flash attention) or ./degraded_setup.sh (without flash-attention)
• Run: ./run.sh or python3.10 app.py
• Test:
  • Full test: python3 tests/test_dataset.py
  • Single model test: bash tests/scripts/dummy_cogvideox_lora.sh (or other model variants)
• Run test suite: bash tests/test_model_runs_minimally_lora.sh

Code Style

• Python version: 3.10 (required for flash-attention compatibility)
• Type hints: Use typing module annotations for all functions (from typing import Any, Optional, Dict, List, Union, Tuple)
• Docstrings: Google style with Args/Returns sections for all functions
• Error handling: Use try/except with specific exceptions, log errors appropriately
• Imports: Group standard lib, third-party, and project imports
• Naming: snake_case for functions/variables, PascalCase for classes
• Use Path objects from pathlib instead of string paths
• Extract reusable logic to separate utility functions
• Environment variables: Use parse_bool_env for boolean env vars
• Logging: Use the logging module with appropriate log levels (DEBUG, INFO, WARNING, ERROR)
• UI components: Organize in tabs and use consistent naming for components dict