"""
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 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 ""
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:
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=/workspace/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} "
)
@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,
train_script: str = "train.py",
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")
exec_command(
"pkill -9 sglang; "
"sleep 3; "
f"{'' if external_ray else 'ray stop --force; '}"
f"{'' if external_ray else 'pkill -9 ray; '}"
"pkill -9 slime; "
"sleep 3; "
f"{'' if external_ray else 'pkill -9 ray; '}"
"pkill -9 slime; "
"pkill -9 redis; "
"true; "
)
if not external_ray:
exec_command(
f"export PYTHONBUFFERED=16 && "
f"ray start --head --node-ip-address {master_addr} --num-gpus {num_gpus_per_node} --resources='{{\"NPU\": {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": f"/workspace/Megatron-LM:/workspace/Megatron-Bridge/src:/workspace/MindSpeed:{os.environ.get('PYTHONPATH', '')}",
"SLIME_ENABLE_PROFILING": "False",
"RAY_EXPERIMENTAL_NOSET_ASCEND_RT_VISIBLE_DEVICES": "1",
"RAY_ACCEL_ENV_VAR_OVERRIDE_ON_ZERO": "0",
"ASCEND_RT_VISIBLE_DEVICES": "0,1,2,3,4,5,6,7",
"RAY_EXPERIMENTAL_NOSET_CUDA_VISIBLE_DEVICES": "1",
"CUDA_VISIBLE_DEVICES": "0,1,2,3,4,5,6,7",
"CUDA_DEVICE_MAX_CONNECTIONS": "1",
"NCCL_NVLS_ENABLE": str(int(check_has_nvlink())),
"no_proxy": f"127.0.0.1,{master_addr}",
"MASTER_ADDR": master_addr,
"PYTHONHASHSEED": "1234",
"HCCL_DETERMINISTIC": "True",
"LCCL_DETERMINISTIC": "1",
"CLOSE_MATMUL_K_SHIFT": "1",
"ATB_LLM_LCOC_ENABLE": "0",
**(
{
"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 PYTHONBUFFERED=16 && "
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_script} "
f"{'${MODEL_ARGS[@]}' if megatron_model_type is not None else ''} "
f"{train_args}"
)
def execute_train_npu(
train_args: str,
megatron_model_type: str | None,
train_script: str = "train.py",
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")
train_backend_fsdp = "--train-backend fsdp" in train_args
assert train_backend_fsdp == (megatron_model_type is None)
exec_command(
"pkill -9 sglang; "
"sleep 3; "
f"{'' if external_ray else 'ray stop --force; '}"
f"{'' if external_ray else 'pkill -9 ray; '}"
"pkill -9 slime; "
"sleep 3; "
f"{'' if external_ray else 'pkill -9 ray; '}"
"pkill -9 slime; "
"pkill -9 redis; "
"true; "
)
if not external_ray:
exec_command(
f"export PYTHONBUFFERED=16 && "
f"ray start --head --node-ip-address {master_addr} --disable-usage-stats"
)
f = before_ray_job_submit
if f is not None:
f()
runtime_env_json = json.dumps(
{
"env_vars": {
"CUDA_DEVICE_MAX_CONNECTIONS": "1",
"RAY_EXPERIMENTAL_NOSET_ASCEND_RT_VISIBLE_DEVICES": "1",
"RAY_ACCEL_ENV_VAR_OVERRIDE_ON_ZERO": "0",
"ASCEND_RT_VISIBLE_DEVICES": os.environ.get("ASCEND_RT_VISIBLE_DEVICES", "0,1,2,3,4,5,6,7"),
"RAY_EXPERIMENTAL_NOSET_CUDA_VISIBLE_DEVICES": "1",
"CUDA_VISIBLE_DEVICES": os.environ.get("CUDA_VISIBLE_DEVICES", "0,1,2,3,4,5,6,7"),
"HYDRA_FULL_ERROR": "1",
"HCCL_HOST_SOCKET_PORT_RANGE": "60000-60050",
"HCCL_NPU_SOCKET_PORT_RANGE": "61000-61050",
**(
{}
if train_backend_fsdp
else {
"CUDA_DEVICE_MAX_CONNECTIONS": "1",
}
),
"NCCL_NVLS_ENABLE": str(int(check_has_nvlink())),
"no_proxy": f"127.0.0.1,{master_addr}",
"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 PYTHONBUFFERED=16 && "
f"{cmd_megatron_model_source}"
f"sleep 60 && "
f'ray job submit --address="http://127.0.0.1:8265" '
f"--runtime-env-json='{runtime_env_json}' "
f"-- python3 {train_script} "
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}"
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()
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",
}