Memory Management › Key Parameters
Michael BrenndoerferJanuary 16, 20262 min read
Language AI HandbookAll chapters Part 31 of 67Training Infrastructure
Memory Management › Key ParametersOne section · Sections in this chapter7 / 10 ↓
Sections in this chapter10
Reading tools Definitions & inline links
Choose your expertise level to adjust how many terms are explained. Beginners see more tooltips, experts see fewer to maintain reading flow. Hover over underlined terms for instant definitions.
Article links
Make inline references clickable
The key configuration parameters that control memory usage during transformer training are:
- batch_size: Controls activation memory linearly. Halving batch size halves activation memory but may require more gradient accumulation steps to maintain the effective batch size.
- seq_len / max_position_embeddings: Controls both the attention term and the linear activation terms. Doubling sequence length roughly quadruples attention activation memory and doubles all other activation memory, for an overall factor slightly less than 4x depending on the model's dimension.
- num_layers: Controls how many layers' activations must be stored simultaneously. Gradient checkpointing amortizes this to one layer regardless of depth.
- hidden_dim: Controls the linear activation memory per token and the parameter count per layer. Scaling hidden dimension has a quadratic effect on parameter count (through the attention projection terms) and a linear effect on per-token activation memory.
- optimizer: Adam requires 8 bytes per parameter for states; alternatives like Lion (4 bytes), SGD (4 bytes), or 8-bit Adam (2 bytes) can significantly reduce this. AdaFactor's factored representation provides sub-linear scaling but requires careful learning rate tuning.
- param_dtype: BF16 parameters halve parameter memory compared to FP32. Mixed precision typically uses FP16/BF16 parameters with FP32 gradients and optimizer states.
- gradient_checkpointing: Reduces activation memory from to at the cost of approximately 33% more forward pass compute.