hud-python 0.4.27__py3-none-any.whl → 0.4.29__py3-none-any.whl

hud/cli/rl/__init__.py

@@ -1,91 +1,583 @@
-"""HUD RL - Commands for reinforcement learning with HUD environments."""
+"""RL training command for HUD CLI."""
 
 from __future__ import annotations
 
-from pathlib import Path  # noqa: TC003
+import asyncio
+import logging
+import os
+import subprocess
+import sys
+from pathlib import Path
 
 import typer
+from rich.console import Console
 
-from hud.utils.hud_console import HUDConsole
+from hud.cli.utils.tasks import find_tasks_file
+from hud.rl.config import validate_vl_model
+from hud.rl.train import train
 
-# Create the RL subcommand app
-rl_app = typer.Typer(
-    name="rl",
-    help="🤖 Reinforcement learning commands for HUD environments",
-    rich_markup_mode="rich",
-)
+# Then import HUD modules
+from hud.utils.hud_console import hud_console
+from hud.utils.tasks import load_tasks
 
-hud_console = HUDConsole()
+from .config import generate_config_interactive, load_config, save_config
+from .display import display_config_summary, display_gpu_info
 
+# Import local modules first
+from .gpu import detect_cuda_devices, validate_gpu_memory
+from .gpu_utils import adjust_config_for_ddp, calculate_optimal_gpu_allocation, health_check_gpus
+from .presets import get_training_presets
+from .vllm import start_vllm_server, wait_for_vllm_server
 
-@rl_app.callback(invoke_without_command=True)
-def rl_main(
-    ctx: typer.Context,
-    model: str = typer.Option("Qwen/Qwen2.5-3B-Instruct", "--model", "-m", help="Model to train"),
-    dataset: str | None = typer.Option(
+console = Console()
+
+
+def rl_command(
+    tasks_file: str | None = typer.Argument(
+        None,
+        help="Path to tasks file (JSON/JSONL) or HuggingFace dataset name",
+    ),
+    model: str | None = typer.Argument(
+        None,
+        help="Model to train (default: interactive selection)",
+    ),
+    config_file: Path | None = typer.Option(  # noqa: B008
+        None,
+        "--config",
+        "-c",
+        help="Path to existing configuration file",
+    ),
+    output_dir: str = typer.Option(
+        "/checkpoints",
+        "--output-dir",
+        "-o",
+        help="Output directory for checkpoints",
+    ),
+    restart: bool = typer.Option(
+        False,
+        "--restart",
+        help="Restart the vLLM server before training",
+    ),
+    verbose: bool = typer.Option(
+        False,
+        "--verbose",
+        "-v",
+        help="Enable verbose output",
+    ),
+    # DDP options
+    no_ddp: bool = typer.Option(
+        False,
+        "--no-ddp",
+        help="Disable DDP even with multiple GPUs",
+    ),
+    ddp_gpus: str | None = typer.Option(
         None,
-        "--dataset",
-        "-d",
-        help="Dataset: JSON file path or HuggingFace name (auto-detects if not provided)",
+        "--ddp-gpus",
+        help="Specific GPUs for DDP (e.g., '0,1,2,3')",
+    ),
+    vllm_gpu: int | None = typer.Option(
+        None,
+        "--vllm-gpu",
+        help="Specific GPU for vLLM server",
+    ),
+    # Execution mode options
+    local: bool = typer.Option(
+        False,
+        "--local",
+        help="Run training locally instead of using remote API server",
+    ),
+    # Internal flag
+    skip_vllm_startup: bool = typer.Option(
+        False,
+        hidden=True,
+        help="Skip local vLLM server startup (for internal use)",
     ),
-    config: Path | None = typer.Option(None, "--config", "-c", help="Config YAML path"),  # noqa: B008
-    gpus: str = typer.Option("2xA100", "--gpus", help="GPU configuration (e.g., 2xA100, 4xH100)"),
-    provider: str = typer.Option("prime", "--provider", help="Infrastructure provider"),
-    output_dir: Path = typer.Option("./checkpoints", "--output", "-o", help="Output directory"),  # noqa: B008
 ) -> None:
-    """🤖 Train RL models on HUD environments.
-
-    Runs training on remote GPU infrastructure with automatic setup.
-    The command will:
-    1. Check for required files (config, dataset)
-    2. Offer to generate missing files
-    3. Push environment to registry if needed
-    4. Start remote training on Prime Intellect
-
-    Dataset can be:
-    - A local JSON file with tasks (e.g., tasks.json)
-    - A HuggingFace dataset name (e.g., 'username/dataset-name')
-    - Auto-detected from current directory if not specified
-
-    Examples:
-        hud rl                    # Interactive mode, auto-detect tasks.json
-        hud rl --model gpt2       # Train with specific model
-        hud rl --dataset tasks.json  # Use local task file
-        hud rl --gpus 4xH100      # Use different GPU configuration
-        hud rl init my-env:latest # Generate config for environment
-    """
-    # Only run main command if no subcommand was invoked
-    if ctx.invoked_subcommand is None:
-        from .train import train_command_wrapper
-
-        train_command_wrapper(
-            model=model,
-            dataset=dataset,
-            config=config,
-            gpus=gpus,
-            provider=provider,
-            output_dir=output_dir,
+    """Run GRPO reinforcement learning training on tasks."""
+    # Configure logging based on verbose flag BEFORE any output
+    if not verbose:
+        # Set environment variable for HUD components
+        os.environ["HUD_LOG_LEVEL"] = "WARNING"
+
+        # Configure logging levels
+        logging.basicConfig(level=logging.WARNING, force=True)
+
+        # Get root logger and set its level
+        root_logger = logging.getLogger()
+        root_logger.setLevel(logging.WARNING)
+
+        # Suppress INFO logs from various components
+        for logger_name in [
+            "httpx",
+            "hud.agents",
+            "hud.utils.design",
+            "hud",
+            "asyncio",
+            "transformers",
+        ]:
+            logging.getLogger(logger_name).setLevel(logging.WARNING)
+
+        # Also set HUD agent logger explicitly
+        logging.getLogger("hud.agents.base").setLevel(logging.WARNING)
+    else:
+        # In verbose mode, show everything
+        logging.basicConfig(level=logging.INFO)
+
+    hud_console.header("HUD RL Training")
+
+    # Determine execution mode
+    use_remote = not local
+
+    if not tasks_file:
+        tasks_file = find_tasks_file(tasks_file)
+        if not tasks_file:
+            console.print("[red]❌ No tasks file found in current directory[/red]")
+            raise typer.Exit(1)
+
+    # Handle remote execution
+    if use_remote:
+        try:
+            from .remote_runner import run_remote_training
+
+            run_remote_training(
+                tasks_file=tasks_file, model=model, config_file=config_file, output_dir=output_dir
+            )
+            return
+        except Exception as e:
+            console.print(f"[red]❌ Remote training failed: {e!s}[/red]")
+            raise typer.Exit(1) from e
+
+    # Check Python version compatibility
+    python_version = sys.version_info
+    if python_version.major == 3 and python_version.minor >= 13:
+        console.print("[red]⚠️  Warning: Python 3.13+ detected![/red]")
+        console.print("[yellow]vLLM has compatibility issues with Python 3.13.[/yellow]")
+        console.print("[yellow]Recommended: Use Python 3.12 or 3.11[/yellow]")
+        console.print("\n[dim]To create a new environment with Python 3.12:[/dim]")
+        console.print("[dim]  1. Exit this shell: exit[/dim]")
+        console.print("[dim]  2. Remove current venv: sudo rm -rf .venv[/dim]")
+        console.print("[dim]  3. Create new venv: uv venv --python 3.12[/dim]")
+        console.print("[dim]  4. Install dependencies: uv pip install -e '.[rl]'[/dim]")
+
+        if not typer.confirm("\nDo you want to continue anyway?", default=False):
+            raise typer.Exit(1)
+
+    # Step 1: Validate CUDA devices
+    console.print("[yellow]Checking GPU availability...[/yellow]")
+    gpu_info = detect_cuda_devices()
+
+    if not gpu_info["available"]:
+        console.print(f"[red]❌ {gpu_info['error']}[/red]")
+        console.print("[yellow]RL training requires CUDA-capable GPUs[/yellow]")
+        raise typer.Exit(1)
+
+    display_gpu_info(gpu_info)
+
+    # Perform GPU health check
+    all_gpu_indices = [device["index"] for device in gpu_info["devices"]]
+    health_results = health_check_gpus(all_gpu_indices)
+
+    if not health_results["all_healthy"]:
+        console.print("\n[yellow]⚠️  Some GPUs failed health checks![/yellow]")
+        console.print(
+            f"[yellow]Unhealthy GPUs: {list(health_results['unhealthy_gpus'].keys())}[/yellow]"
+        )
+
+        if not health_results["healthy_gpus"]:
+            console.print("[red]❌ No healthy GPUs available for training![/red]")
+            raise typer.Exit(1)
+
+        console.print(
+            f"\n[cyan]You have {len(health_results['healthy_gpus'])} healthy GPUs available.[/cyan]"
         )
 
+        continue_training = typer.confirm("\nContinue with healthy GPUs only?", default=True)
+
+        if not continue_training:
+            healthy_str = ",".join(map(str, health_results["healthy_gpus"]))
+            console.print("\n[yellow]Exiting. Please resolve GPU issues and try again.[/yellow]")
+            console.print("\n[cyan]💡 Tip: To use only healthy GPUs, you can run:[/cyan]")
+            console.print(f"[white]hud rl {tasks_file} --ddp-gpus {healthy_str} --local[/white]\n")
+            raise typer.Exit(0)
+        else:
+            # Continue with healthy GPUs only
+            # Update gpu_info to only include healthy GPUs
+            gpu_info["devices"] = [
+                d for d in gpu_info["devices"] if d["index"] in health_results["healthy_gpus"]
+            ]
+            console.print(
+                f"\n[green]✅ Continuing with {len(gpu_info['devices'])} healthy GPUs[/green]"
+            )
+
+    # Get primary GPU memory for configuration
+    primary_gpu = gpu_info["devices"][0]
+    gpu_memory_gb = primary_gpu["memory_gb"]
+
+    # Validate GPU memory for 3B model
+    if not validate_gpu_memory(gpu_memory_gb, "3B"):
+        console.print(f"[red]❌ Insufficient GPU memory ({gpu_memory_gb:.1f} GB)[/red]")
+        console.print("[yellow]Qwen 2.5 VL 3B requires at least 12 GB of GPU memory[/yellow]")
+        raise typer.Exit(1)
+
+    # Step 2: Load tasks
+    if tasks_file:
+        console.print(f"\n[cyan]Loading tasks from: {tasks_file}[/cyan]")
+    else:
+        # Auto-detect tasks file
+        possible_files = ["tasks.json", "tasks.jsonl", "browser_2048_tasks.jsonl"]
+        for f in possible_files:
+            if Path(f).exists():
+                tasks_file = f
+                console.print(f"[green]Auto-detected tasks file: {f}[/green]")
+                break
+
+        if not tasks_file:
+            console.print("[red]❌ No tasks file specified or auto-detected[/red]")
+            console.print(
+                "[yellow]Please provide a tasks file or create one of: tasks.json, tasks.jsonl[/yellow]"  # noqa: E501
+            )
+            raise typer.Exit(1)
+
+    # Load the tasks
+    tasks = load_tasks(tasks_file)
+    console.print(f"[green]✅ Loaded {len(tasks)} tasks[/green]")
+
+    # Validate tasks
+    invalid_tasks = []
+    for i, task in enumerate(tasks):
+        if not hasattr(task, "prompt") or not task.prompt:
+            invalid_tasks.append(f"Task {i}: missing 'prompt' field")
+        if not hasattr(task, "mcp_config") or not task.mcp_config:
+            invalid_tasks.append(f"Task {i}: missing 'mcp_config' field")
+
+    if invalid_tasks:
+        console.print("[red]❌ Invalid tasks found:[/red]")
+        for error in invalid_tasks[:5]:  # Show first 5 errors
+            console.print(f"  - {error}")
+        if len(invalid_tasks) > 5:
+            console.print(f"  ... and {len(invalid_tasks) - 5} more")
+        raise typer.Exit(1)
+
+    # Step 3: Model selection (if not provided)
+    if model is None and not config_file:
+        model = hud_console.select(
+            "Select a model for RL training:",
+            choices=[
+                {
+                    "name": "Qwen 2.5 VL 3B (Recommended - Vision-Language)",
+                    "value": "Qwen/Qwen2.5-VL-3B-Instruct",
+                },
+                {"name": "Custom model", "value": "custom"},
+            ],
+            default=0,
+        )
 
-@rl_app.command()
-def init(
-    directory: str = typer.Argument(".", help="Environment directory or Docker image"),
-    output: Path = typer.Option(None, "--output", "-o", help="Output config file path"),  # noqa: B008
-    force: bool = typer.Option(False, "--force", "-f", help="Overwrite existing config"),
-    build: bool = typer.Option(False, "--build", "-b", help="Build environment if no lock file"),
+        if model == "custom":
+            console.print("Enter the model name (HuggingFace ID):")
+            model = input().strip()
+
+    # Validate model is a VL model (whether provided via CLI or selected)
+    if model:
+        try:
+            validate_vl_model(model)
+        except ValueError as e:
+            console.print(f"\n[red]❌ {e}[/red]")
+            raise typer.Exit(1) from e
+    else:
+        raise typer.Exit(1)
+
+    # Step 4: Generate or load configuration
+    if config_file:
+        console.print(f"\n[cyan]Loading configuration from: {config_file}[/cyan]")
+        config = load_config(config_file)
+
+        # Validate model from config
+        if hasattr(config, "model") and hasattr(config.model, "base_model"):
+            try:
+                validate_vl_model(config.model.base_model)
+            except ValueError as e:
+                console.print(f"\n[red]❌ {e}[/red]")
+                raise typer.Exit(1) from e
+
+        # Estimate memory for display
+        from .presets import estimate_memory_usage
+
+        estimated_memory = estimate_memory_usage(
+            config.training.mini_batch_size,
+            config.actor.max_steps_per_episode,
+            config.actor.max_new_tokens,
+            config.model.max_pixels,
+        )
+    else:
+        console.print("\n[cyan]Generating training configuration...[/cyan]")
+        # Get number of GPUs for preset scaling
+        num_training_gpus = 1  # Default, will be adjusted later
+        if len(gpu_info["devices"]) > 2:
+            # If we have many GPUs, presets will show scaled values
+            num_training_gpus = len(gpu_info["devices"]) - 1  # Reserve 1 for vLLM
+            console.print(
+                f"[yellow]Note: Episodes will be scaled for {num_training_gpus} training GPUs[/yellow]\n"  # noqa: E501
+            )
+
+        presets = get_training_presets(gpu_memory_gb)
+        config, estimated_memory = generate_config_interactive(
+            model_name=model,
+            presets=presets,
+        )
+
+    # Step 5: Save temporary config and display summary
+    temp_config_path = Path(".rl_config_temp.json")
+    save_config(config, temp_config_path)
+    console.print(f"\n[cyan]📝 Configuration saved to: {temp_config_path.absolute()}[/cyan]")
+    console.print("[yellow]You can edit this file before starting training.[/yellow]")
+
+    # Display configuration summary
+    display_config_summary(config, len(tasks), gpu_info, estimated_memory)
+
+    # Step 6: Ask for confirmation (skip if config was provided)
+    if not config_file:
+        console.print("\n[bold yellow]Options:[/bold yellow]")
+        console.print("  • Type [green]'start'[/green] to begin training")
+        console.print("  • Type [cyan]'edit'[/cyan] to open config in your editor")
+        console.print("  • Type [red]'cancel'[/red] to abort")
+        console.print("\n[bold]Your choice:[/bold] ", end="")
+
+        while True:
+            choice = input().strip().lower()
+
+            if choice == "start":
+                # Reload config in case it was edited
+                config = load_config(temp_config_path)
+                break
+            elif choice == "edit":
+                # Default to nano if EDITOR is not set
+                editor = os.environ.get("EDITOR", "nano")
+
+                # Show nano instructions if using nano
+                if editor == "nano":
+                    console.print("\n[cyan]Opening config in nano editor...[/cyan]")
+                    console.print("[yellow]Tips:[/yellow]")
+                    console.print("  • Edit the configuration values as needed")
+                    console.print("  • Press [bold]Ctrl+O[/bold] then [bold]Enter[/bold] to save")
+                    console.print("  • Press [bold]Ctrl+X[/bold] to exit")
+                    console.print("  • Press [bold]Ctrl+C[/bold] to cancel without saving\n")
+                    input("Press Enter to continue...")
+
+                try:
+                    subprocess.run([editor, str(temp_config_path)], check=True)  # noqa: S603
+                    # Reload and display updated config
+                    config = load_config(temp_config_path)
+                    estimated_memory = estimate_memory_usage(
+                        config.training.mini_batch_size,
+                        config.actor.max_steps_per_episode,
+                        config.actor.max_new_tokens,
+                        config.model.max_pixels,
+                    )
+                    display_config_summary(config, len(tasks), gpu_info, estimated_memory)
+                    console.print(
+                        "\n[bold]Type 'start' to begin or 'cancel' to abort:[/bold] ", end=""
+                    )
+                except subprocess.CalledProcessError:
+                    console.print(
+                        "\n[yellow]Editor closed without saving or was cancelled.[/yellow]"
+                    )
+                    console.print("[bold]Your choice:[/bold] ", end="")
+                except Exception as e:
+                    console.print(f"\n[red]Failed to open editor: {e}[/red]")
+                    console.print(
+                        f"[yellow]Please edit {temp_config_path} manually and type 'start' when ready.[/yellow]"  # noqa: E501
+                    )
+                    console.print("[bold]Your choice:[/bold] ", end="")
+            elif choice == "cancel":
+                console.print("[red]Training cancelled[/red]")
+
+                # Ask if they want to save the config
+                if typer.confirm("Save this configuration for later?", default=True):
+                    config_path = Path("rl_config.json")
+                    save_config(config, config_path)
+
+                # Clean up temp file
+                try:
+                    temp_config_path.unlink()
+                except Exception as e:
+                    hud_console.warning(f"Failed to clean up temp config: {e}")
+
+                raise typer.Exit(0)
+            else:
+                console.print(
+                    "[red]Invalid choice. Type 'start', 'edit', or 'cancel':[/red] ", end=""
+                )
+    else:
+        # Config was provided, proceed directly
+        console.print("\n[dim]Using provided configuration file...[/dim]")
+        config = load_config(temp_config_path)
+
+    # Step 7: Determine if DDP should be used
+    num_gpus = len(gpu_info["devices"])
+    use_ddp = False
+    training_gpus = [0]  # Default single GPU
+    vllm_gpu_idx = 1 if num_gpus > 1 else 0
+
+    if num_gpus > 2 and not no_ddp:
+        console.print(f"\n[cyan]🚀 Detected {num_gpus} GPUs - checking DDP configuration...[/cyan]")
+
+        # Calculate optimal GPU allocation
+        gpu_allocation = calculate_optimal_gpu_allocation(gpu_info, config)
+
+        if gpu_allocation["use_ddp"]:
+            use_ddp = True
+            training_gpus = gpu_allocation["training_gpus"]
+            vllm_gpu_idx = gpu_allocation["vllm_gpu"]
+
+            console.print(
+                f"[green]✅ Will use DDP with {len(training_gpus)} GPUs for training[/green]"
+            )
+            console.print(f"[green]✅ GPU {vllm_gpu_idx} reserved for vLLM server[/green]")
+
+            # Show details
+            console.print("\n[cyan]Training Configuration:[/cyan]")
+            console.print(f"  • Groups to process: {gpu_allocation['num_groups']}")
+            console.print(f"  • Training GPUs: {training_gpus}")
+            console.print(f"  • Groups per GPU: {gpu_allocation.get('groups_per_gpu', 'N/A'):.1f}")
+
+            # Warn about efficiency
+            if gpu_allocation.get("parallel_efficiency", 1.0) < 0.8:
+                console.print(
+                    f"\n[yellow]⚠️  GPU efficiency: {gpu_allocation['parallel_efficiency'] * 100:.0f}%[/yellow]"  # noqa: E501
+                )
+                console.print(
+                    f"[yellow]Consider adjusting batch_size to {len(training_gpus) * config.training.group_size} for optimal performance[/yellow]"  # noqa: E501
+                )
+        else:
+            console.print(f"[cyan]{gpu_allocation.get('reason', 'Using single GPU')}[/cyan]")
+
+    # Allow manual override
+    if ddp_gpus is not None:
+        requested_gpus = [int(x) for x in ddp_gpus.split(",")]
+        console.print(f"[cyan]Manual GPU selection: {requested_gpus}[/cyan]")
+        # Validate requested GPUs are in the healthy set
+        available_indices = [d["index"] for d in gpu_info["devices"]]
+        invalid_gpus = [g for g in requested_gpus if g not in available_indices]
+        if invalid_gpus:
+            console.print(f"[red]❌ Invalid/unhealthy GPU(s) requested: {invalid_gpus}[/red]")
+            console.print(f"[yellow]Available healthy GPUs: {available_indices}[/yellow]")
+            raise typer.Exit(1)
+        training_gpus = requested_gpus
+        use_ddp = len(training_gpus) > 1
+
+    if vllm_gpu is not None:
+        vllm_gpu_idx = vllm_gpu
+        console.print(f"[cyan]Manual vLLM GPU: {vllm_gpu_idx}[/cyan]")
+        # Validate vLLM GPU is in the healthy set
+        available_indices = [d["index"] for d in gpu_info["devices"]]
+        if vllm_gpu_idx not in available_indices:
+            console.print(f"[red]❌ vLLM GPU {vllm_gpu_idx} is not available/healthy![/red]")
+            console.print(f"[yellow]Available healthy GPUs: {available_indices}[/yellow]")
+            raise typer.Exit(1)
+
+    # Ensure we have at least one training GPU
+    if not training_gpus:
+        console.print("[red]❌ No available GPUs for training![/red]")
+        raise typer.Exit(1)
+
+    # Always adjust batch_size based on number of training GPUs
+    config = adjust_config_for_ddp(config, len(training_gpus))
+
+    # Save updated config (for both DDP and single GPU)
+    save_config(config, temp_config_path)
+
+    # Step 8: Start vLLM server (unless we're using a remote one)
+    if not skip_vllm_startup:
+        console.print(f"\n[cyan]Setting up vLLM server on GPU {vllm_gpu_idx}...[/cyan]")
+
+        start_vllm_server(config.model.base_model, vllm_gpu_idx, restart=restart)
+
+        # Wait for server to be ready
+        server_ready = asyncio.run(wait_for_vllm_server())
+        if not server_ready:
+            console.print("[red]❌ Failed to start vLLM server[/red]")
+            raise typer.Exit(1)
+    else:
+        console.print("\n[cyan]Using remote vLLM server (skipping local startup)[/cyan]")
+
+    # Step 9: Run training (DDP or single GPU)
+    if use_ddp:
+        console.print(
+            f"\n[bold green]🎯 Starting DDP training on {len(training_gpus)} GPUs...[/bold green]\n"
+        )
+        launch_ddp_training(training_gpus, tasks_file, temp_config_path, verbose)
+        console.print("\n[green]✅ Training completed successfully![/green]")
+    else:
+        console.print("\n[bold green]🎯 Starting single-GPU training...[/bold green]\n")
+        try:
+            # Set verbose in config instead of passing as parameter
+            if verbose:
+                config.verbose = True
+
+            # Run the async training function
+            asyncio.run(train(config, tasks))
+            console.print("\n[green]✅ Training completed successfully![/green]")
+
+            # Clean up temp config file
+            try:
+                temp_config_path.unlink()
+            except Exception as e:
+                hud_console.warning(f"Failed to clean up temp config: {e}")
+
+        except KeyboardInterrupt:
+            console.print("\n[yellow]Training interrupted by user[/yellow]")
+            raise typer.Exit(1)  # noqa: B904
+        except Exception as e:
+            console.print(f"\n[red]❌ Training failed: {e}[/red]")
+            raise typer.Exit(1) from e
+
+
+def launch_ddp_training(
+    training_gpus: list[int], tasks_file: str, config_path: Path, verbose: bool
 ) -> None:
-    """🔧 Generate hud-vf-gym config from environment.
+    """Launch DDP training with torchrun."""
+    import subprocess
+    import sys
+
+    # Prepare environment
+    env = os.environ.copy()
+    env["CUDA_VISIBLE_DEVICES"] = ",".join(map(str, training_gpus))
+
+    if not verbose:
+        env["HUD_LOG_LEVEL"] = "WARNING"
+
+    # Build command
+    cmd = [
+        sys.executable,
+        "-m",
+        "torch.distributed.run",
+        f"--nproc_per_node={len(training_gpus)}",
+        "--master_port=29500",
+        "-m",
+        "hud.rl.train",
+        "--config",
+        str(config_path),
+        "--tasks",
+        tasks_file,
+    ]
+
+    # Add verbose flag if enabled
+    if verbose:
+        cmd.append("--verbose")
 
-    Generates a YAML configuration file compatible with the hud-vf-gym adapter
-    from either a directory with hud.lock.yaml or a Docker image.
+    try:
+        # Run DDP training
+        subprocess.run(cmd, env=env, check=True)  # noqa: S603
+    except subprocess.CalledProcessError as e:
+        console.print(f"\n[red]❌ DDP training failed with exit code {e.returncode}[/red]")
+        raise typer.Exit(1) from e
+    finally:
+        # Cleanup temp config
+        try:
+            config_path.unlink()
+        except Exception as e:
+            hud_console.warning(f"Failed to clean up temp config: {e}")
 
-    Examples:
-        hud rl init                    # Use current directory
-        hud rl init environments/test  # Use specific directory
-        hud rl init my-env:latest      # Use Docker image directly
-        hud rl init . -o configs/2048.yaml --build
-    """
-    from .init import init_command_wrapper
 
-    init_command_wrapper(directory, output, force, build)
+# Export the command function
+__all__ = ["rl_command"]