""" This file is not for slime framework itself, but as an optional utility to easily launch slime jobs and tests. """ import datetime import json import os import random import subprocess import time from dataclasses import dataclass from pathlib import Path from slime.utils.external_utils.typer_utils import dataclass_cli from slime.utils.misc import exec_command _ = exec_command, dataclass_cli repo_base_dir = Path(os.path.abspath(__file__)).resolve().parents[3] def convert_checkpoint( model_name, megatron_model_type, num_gpus_per_node: int, multinode: bool = False, extra_args: str = "", dir_dst: str = "/root", hf_checkpoint: str | None = None, ): hf_checkpoint = hf_checkpoint or f"/root/models/{model_name}" normalized_extra_args = f" {extra_args.strip()}" if extra_args.strip() else "" # TODO shall we make it in host-mapped folder and thus can cache it to speedup CI path_dst = f"{dir_dst}/{model_name}_torch_dist" if Path(path_dst).exists(): print(f"convert_checkpoint skip {path_dst} since exists") return multinode_args = "" if multinode: # This variable can be provided via: # `export SLURM_JOB_HOSTNAMES=$(scontrol show hostnames "$SLURM_JOB_NODELIST")` print(f"{os.environ.get('SLURM_JOB_HOSTNAMES')=} {os.environ.get('SLURM_NODEID')=}") job_hostnames = os.environ["SLURM_JOB_HOSTNAMES"].strip().split("\n") master_addr = job_hostnames[0] nnodes = len(job_hostnames) node_rank = int(os.environ["SLURM_NODEID"]) multinode_args = ( f"--master-addr {master_addr} " "--master-port 23456 " f"--nnodes={nnodes} " f"--node-rank {node_rank} " ) exec_command( f"source {repo_base_dir}/scripts/models/{megatron_model_type}.sh && " f"PYTHONPATH={repo_base_dir}:/root/Megatron-LM:${{PYTHONPATH:-}} " f"torchrun " f"--nproc-per-node {num_gpus_per_node} " f"{multinode_args}" f"tools/convert_hf_to_torch_dist.py " "${MODEL_ARGS[@]} " f"--hf-checkpoint {hf_checkpoint} " f"--save {path_dst}" f"{normalized_extra_args}" ) def rsync_simple(path_src: str, path_dst: str): exec_command(f"mkdir -p {path_dst} && rsync -a --info=progress2 {path_src}/ {path_dst}") def hf_download_dataset(full_name: str): _, partial_name = full_name.split("/") exec_command(f"hf download --repo-type dataset {full_name} --local-dir /root/datasets/{partial_name}") def fp8_cast_bf16(path_src, path_dst): if Path(path_dst).exists(): print(f"fp8_cast_bf16 skip {path_dst} since exists") return exec_command( "python tools/fp8_cast_bf16.py " f"--input-fp8-hf-path {path_src} " f"--output-bf16-hf-path {path_dst} " ) # This class can be extended by concrete scripts @dataclass class ExecuteTrainConfig: cuda_core_dump: bool = False num_nodes: int = int(os.environ.get("SLURM_JOB_NUM_NODES", "1")) extra_env_vars: str = "" def execute_train( train_args: str, num_gpus_per_node: int, megatron_model_type: str | None, before_ray_job_submit=None, extra_env_vars=None, config: ExecuteTrainConfig | None = None, ): if extra_env_vars is None: extra_env_vars = {} if config is None: config = ExecuteTrainConfig() external_ray = get_bool_env_var("SLIME_SCRIPT_EXTERNAL_RAY") master_addr = os.environ.get("MASTER_ADDR", "127.0.0.1") # Launching another trainer must preserve independently owned serving. # Successful training cleans up its own resources; failures retain them. if not external_ray: # A manual trainer restart must leave the Ray head and its detached # rollout session alive. A stale address file alone is not proof of a # running cluster, so query the head before deciding to start one. ray_running = ( subprocess.run( ["ray", "status"], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL, timeout=30 ).returncode == 0 ) if not ray_running: exec_command( # will prevent ray from buffering stdout/stderr f"export PYTHONUNBUFFERED=1 && " f"ray start --head --node-ip-address {master_addr} --num-gpus {num_gpus_per_node} --disable-usage-stats" ) if (f := before_ray_job_submit) is not None: f() runtime_env_json = json.dumps( { "env_vars": { "PYTHONPATH": "/root/Megatron-LM/", "RAY_USE_UVLOOP": "0", "CUDA_DEVICE_MAX_CONNECTIONS": "1", "NCCL_NVLS_ENABLE": str(int(check_has_nvlink())), "no_proxy": f"127.0.0.1,{master_addr}", # This is needed by megatron / torch distributed in multi-node setup "MASTER_ADDR": master_addr, **( { "CUDA_ENABLE_COREDUMP_ON_EXCEPTION": "1", "CUDA_COREDUMP_SHOW_PROGRESS": "1", "CUDA_COREDUMP_GENERATION_FLAGS": "skip_nonrelocated_elf_images,skip_global_memory,skip_shared_memory,skip_local_memory,skip_constbank_memory", "CUDA_COREDUMP_FILE": "/root/shared_data/cuda_coredump_%h.%p.%t", } if config.cuda_core_dump else {} ), **extra_env_vars, **_parse_extra_env_vars(config.extra_env_vars), } } ) if get_bool_env_var("SLIME_SCRIPT_ENABLE_RAY_SUBMIT", "1"): cmd_megatron_model_source = ( f'source "{repo_base_dir}/scripts/models/{megatron_model_type}.sh" && ' if megatron_model_type is not None else "" ) exec_command( f"export no_proxy=127.0.0.1 && export PYTHONUNBUFFERED=1 && " f"{cmd_megatron_model_source}" f'ray job submit --address="http://127.0.0.1:8265" ' f"--runtime-env-json='{runtime_env_json}' " f"-- python3 train.py " f"{'${MODEL_ARGS[@]}' if megatron_model_type is not None else ''} " f"{train_args}" ) def _parse_extra_env_vars(text: str): try: return json.loads(text) except ValueError: return {kv[0]: kv[1] for item in text.split(" ") if item.strip() != "" if (kv := item.split("=")) or True} def check_has_nvlink(): output = exec_command("nvidia-smi topo -m 2>/dev/null | grep -o 'NV[0-9][0-9]*' | wc -l", capture_output=True) return int(output) > 0 def get_default_wandb_args(test_file: str, run_name_prefix: str | None = None, run_id: str | None = None): if not os.environ.get("WANDB_API_KEY"): print("Skip wandb configuration since WANDB_API_KEY is not found") return "" test_file = Path(test_file) test_name = test_file.stem if len(test_name) < 6: test_name = f"{test_file.parent.name}_{test_name}" wandb_run_name = run_id or create_run_id() if (x := os.environ.get("GITHUB_COMMIT_NAME")) is not None: wandb_run_name += f"_{x}" if (x := run_name_prefix) is not None: wandb_run_name = f"{x}_{wandb_run_name}" # Use the actual key value from environment to avoid shell expansion issues wandb_key = os.environ.get("WANDB_API_KEY") return ( "--use-wandb " f"--wandb-project slime-{test_name} " f"--wandb-group {wandb_run_name} " f"--wandb-key '{wandb_key}' " "--disable-wandb-random-suffix " ) def create_run_id() -> str: return datetime.datetime.utcnow().strftime("%y%m%d-%H%M%S") + f"-{random.Random().randint(0, 999):03d}" _warned_bool_env_var_keys = set() # copied from SGLang def get_bool_env_var(name: str, default: str = "false") -> bool: value = os.getenv(name, default) value = value.lower() truthy_values = ("true", "1") falsy_values = ("false", "0") if (value not in truthy_values) and (value not in falsy_values): if value not in _warned_bool_env_var_keys: print(f"get_bool_env_var({name}) see non-understandable value={value} and treat as false") _warned_bool_env_var_keys.add(value) return value in truthy_values def get_env_enable_infinite_run(): return get_bool_env_var("SLIME_TEST_ENABLE_INFINITE_RUN", "false") def save_to_temp_file(text: str, ext: str): path = Path(f"/tmp/slime_temp_file_{time.time()}_{random.randrange(0, 10000000)}.{ext}") path.write_text(text) print(f"Write the following content to {path=}: {text=}") return str(path) NUM_GPUS_OF_HARDWARE = { "H100": 8, "GB200": 4, "GB300": 4, } GENERATION_HARDWARE = { "H100": "Hopper", "GB200": "Blackwell", "GB300": "Blackwell", }