trinity.trainer.trainer module

trinity.trainer.trainer module#

Trainer Class

class trinity.trainer.trainer.Trainer(config: Config)[源代码]#

基类：object

Consume the experience and train the model.

__init__(config: Config) → None[源代码]#

async prepare() → None[源代码]#: Prepare the trainer.

async get_weight_sync_info() → Tuple[str, int, List] | None[源代码]#

Get rendezvous info for NCCL weight sync group setup.

Returns (master_address, master_port, state_dict_meta) from the trainer's GPU worker rank 0. Called by Synchronizer before coordinating NCCL group creation.

async setup_weight_sync_group(master_address: str, master_port: int, world_size: int, group_name: str, timeout: int) → None[源代码]#: Join the NCCL weight sync group. Called by Synchronizer.

async teardown_weight_sync_group() → None[源代码]#: Destroy the NCCL weight sync group. Called by Synchronizer.

async train() → str[源代码]#: Train the model.

async train_step(exps: List[Experience]) → Dict[源代码]#

Train one step.

返回:: Whether to continue training. Dict: Metrics of the training step.
返回类型:: bool

async need_sync() → bool[源代码]#: Whether to sync the model weight.

need_save() → bool[源代码]#: Whether to save the checkpoint.

async sync_weight() → Dict[源代码]#: Sync the model weight.

async save_checkpoint(block_until_saved: bool = False, save_as_hf: bool = False) → Dict[源代码]#

async shutdown() → None[源代码]#

property train_step_num: int#: Get the current training step number.

async is_alive() → bool[源代码]#: Check if the trainer is alive.

classmethod get_actor(config: Config)[源代码]#: Get a Ray actor for the trainer.

class trinity.trainer.trainer.TrainEngineWrapper[源代码]#

基类：ABC

A wrapper class to wrap various training engines.

abstractmethod async prepare() → None[源代码]#: Do some preparation before training started.

abstract property train_step_num: int#: Get the current training step number.

abstractmethod async train_step(batch_exps: List[Experience]) → Dict[源代码]#

Training one step.

参数:: batch_exps (List[Experience]) -- A batch of experiences to train.
返回:: Metrics of the training step.
返回类型:: Dict

abstractmethod async save_checkpoint(block_until_saved: bool = False, save_as_hf: bool = False) → None[源代码]#: Save the whole checkpoint (Including model, optimizer, and other states).

async wait_for_save() → None[源代码]#

Wait for any pending background save operations to complete.

Default implementation is a no-op. Override in subclasses that use background save threads to ensure the checkpoint iteration file is written before the trainer exits.

abstractmethod sync_weight_nccl() → None[源代码]#: Sync the model weight by NCCL. (For NCCL sync method)

abstractmethod async upload_state_dict() → None[源代码]#: Upload the state dict to Synchronizer. (For MEMORY sync method)

abstractmethod async save_state_dict() → None[源代码]#: Only save the model state dict for Synchronizer. (For CHECKPOINT sync method)

abstractmethod async get_weight_sync_info() → Tuple[str, int, List] | None[源代码]#: Get (master_address, master_port, state_dict_meta) for NCCL group setup.

abstractmethod async setup_weight_sync_group(master_address: str, master_port: int, world_size: int, group_name: str, timeout: int) → None[源代码]#: Join the NCCL weight sync group.

abstractmethod async teardown_weight_sync_group() → None[源代码]#: Tear down the NCCL weight sync group.

trinity.trainer.trainer.is_verl_legacy() → bool[源代码]#: Return True when the installed verl package is < 0.8 (legacy backend).

trinity.trainer.trainer.get_latest_hf_checkpoint_path(config: Config) → str | None[源代码]#: Return the latest HF checkpoint path for a verl trainer config.

trinity.trainer.trainer.get_trainer_wrapper(config: Config) → TrainEngineWrapper[源代码]#: Get a trainer wrapper.

trinity.trainer.trainer module

目录

trinity.trainer.trainer module#