tracel-ai/burn · error

Can delete learning agent checkpoint.

Error message

Can delete learning agent checkpoint.

What it means

Guard in the RL checkpointer's `checkpoint`: deletion of the learning agent checkpoint for the strategy-selected epoch failed; the checkpointer panics because failing to prune agent checkpoints can exhaust storage.

Source

Thrown at crates/burn-train/src/learner/rl/checkpointer.rs:42

    /// Create checkpoint for the training process.
    pub fn checkpoint(
        &mut self,
        policy: &RLC::PolicyState,
        learning_agent: &RLC::LearningAgent,
        epoch: usize,
        store: &EventStoreClient,
    ) {
        let actions = self.strategy.checkpointing(epoch, store);

        for action in actions {
            match action {
                CheckpointingAction::Delete(epoch) => {
                    self.policy
                        .delete(epoch)
                        .expect("Can delete policy checkpoint.");
                    self.learning_agent
                        .delete(epoch)
                        .expect("Can delete learning agent checkpoint.")
                }
                CheckpointingAction::Save => {
                    self.policy
                        .save(epoch, policy.clone().into_record())
                        .expect("Can save policy checkpoint.");
                    self.learning_agent
                        .save(epoch, learning_agent.record())
                        .expect("Can save learning agent checkpoint.");
                }
            }
        }
    }

    /// Load a training checkpoint.
    pub fn load_checkpoint(
        &self,
        learning_agent: RLC::LearningAgent,
        epoch: usize,

View on GitHub (pinned to d16f7ba2ed)

Solutions

1. Verify checkpoint directory writability and disk space
2. Check the epoch exists before deletion if another process may have removed it
3. Surface the inner deletion error for diagnosis

When it happens

Trigger: Thrown at crates/burn-train/src/learner/rl/checkpointer.rs:42 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of tracel-ai/burn@d16f7ba2ed (2026-09-05). Data as JSON: /api/errors/1bc7aaf1b87654d1. Report an issue: GitHub.