scripts/run_qrun.py

#!/usr/bin/env python3
"""Run qlib-native experiment workflow (Alpha158 baseline or GP factors)."""

import argparse
import sys
from pathlib import Path

ROOT = Path(__file__).resolve().parents[1]
if str(ROOT) not in sys.path:
    sys.path.insert(0, str(ROOT))

from experiments.workflow_runner import run_workflow


def main():
    parser = argparse.ArgumentParser(description="Run qlib workflow YAML via task_train + Recorder")
    parser.add_argument(
        "--config",
        type=str,
        default="config/workflows/workflow_alpha158_baseline.yaml",
        help="Workflow YAML path",
    )
    parser.add_argument("--run-id", type=str, default=None, help="GP run id for handler_path injection")
    parser.add_argument("--experiment-name", type=str, default=None, help="Override experiment name")
    args = parser.parse_args()

    run_workflow(
        config_path=args.config,
        experiment_name=args.experiment_name,
        run_id=args.run_id,
    )


if __name__ == "__main__":
    main()