cursor-pytorch

PyTorch Rules

Model Architecture

• Use torch.nn.Module base class for all models
• Initialize layers in init, define forward pass in forward()
• Use meaningful layer names for debugging and model inspection
• Implement proper weight initialization for training stability
• Use torch.nn.Sequential for simple sequential models

Data Handling

• Use torch.utils.data.Dataset for custom datasets
• Implement len and getitem methods properly
• Use DataLoader with appropriate batch_size and num_workers
• Apply transforms consistently using torchvision.transforms
• Handle data augmentation in dataset transform pipeline

Training Loop

• Move model and data to same device (CPU/GPU)
• Use torch.no_grad() for validation and inference
• Clear gradients with optimizer.zero_grad() before backward pass
• Use mixed precision training with torch.cuda.amp for efficiency
• Implement proper checkpointing with state_dict

Memory Management

• Use torch.cuda.empty_cache() to clear GPU memory when needed
• Prefer in-place operations where possible (tensor.add_() vs tensor.add())
• Use gradient accumulation for large effective batch sizes
• Implement proper cleanup in exception handlers
• Monitor GPU memory usage with torch.cuda.memory_stats()

Model Deployment

• Use torch.jit.script or torch.jit.trace for production models
• Save models with torch.save(model.state_dict(), path)
• Use torch.hub for model sharing and distribution
• Implement proper error handling for device compatibility
• Test models on target deployment hardware

Best Practices

• Use torch.manual_seed() for reproducible results
• Validate tensor shapes throughout the pipeline
• Use appropriate loss functions and optimizers for your task
• Implement learning rate scheduling for better convergence
• Use tensorboard or wandb for training visualization