Skip to content

cfregly/ai-performance-engineering

Repository files navigation

AI Performance Engineering

About This Repo

AI Systems Performance Engineering code, tooling, and resources for the O'Reilly book covering GPU optimization, distributed training, inference scaling, and full-stack performance tuning for modern AI workloads.

O'Reilly Book

O'Reilly Book – Fall 2025
Available on Amazon

AI Systems Performance Engineering Checklist

The book ships with a 175+ item performance checklist covering the entire lifecycle:

  • ✅ Performance tuning mindset and cost optimization
  • ✅ Reproducibility and documentation best practices
  • ✅ System architecture and hardware planning
  • ✅ Operating system and driver optimizations
  • ✅ GPU programming and CUDA tuning
  • ✅ Distributed training and network optimization
  • ✅ Efficient inference and serving
  • ✅ Power and thermal management
  • ✅ Latest profiling tools and techniques
  • ✅ Architecture-specific optimizations

Links

Built in San Francisco for the AI performance engineering community

Key Focus Areas

  • GPU Architecture, PyTorch, CUDA, and OpenAI Triton Programming
  • Distributed Training & Inference
  • Memory Optimization & Profiling
  • PyTorch Performance Tuning
  • Multi-Node Scaling Strategies

Quick Start

Prerequisites

  • NVIDIA GPU with CUDA support
  • Python 3.8+
  • PyTorch with CUDA
  • Docker (optional)

Getting Started

# Clone the repository
git clone https://github.com/your-repo/ai-performance-engineering.git
cd ai-performance-engineering

# Install dependencies for a specific chapter
cd code/ch1
pip install -r requirements.txt

# Run examples
python performance_basics.py

# Profiling-friendly workloads
# Most examples use modest tensor sizes and short iteration counts so Nsight
# Systems, Nsight Compute, and the PyTorch profiler finish quickly. Increase the
# sizes if you need larger-scale numbers.

Blackwell Workflow

The repository targets NVIDIA Blackwell B200/B300 (SM100). CUDA builds, Nsight workflows, and PyTorch stacks assume CUDA 12.9, PyTorch 2.9 nightlies, and Triton 3.4. Helper scripts keep everything aligned:

# Build CUDA samples and run sanity checks
./code/build_all.sh

# Profile the entire codebase with Nsight + PyTorch profiler
python scripts/profile_harness.py --profile nsys --profile pytorch --output-root profiles/full_run

# Reset generated profiling artifacts
./clean_profiles.sh

For environment variables, validation scripts, and hardware guidance, see docs/environment.md.

Latest Stack Updates

  • PyTorch 2.9: Enhanced compiler, dynamic shapes, improved profiler
  • CUDA 12.9: Latest Blackwell features and kernel performance updates
  • Triton 3.4: Architecture-specific kernels and optimizations
  • Nsight 2024.x: Refreshed kernel and timeline analysis capabilities
  • HTA: Holistic Tracing Analysis for multi-GPU systems
  • perf: Enhanced system-level sampling workflows
  • Unified Profiling Harness: One command covers Nsight Systems/Compute and the PyTorch profiler

Documentation Map

  • Chapter guide: See the section below for chapter-by-chapter themes and learning goals
  • docs/tooling-and-profiling.md: Nsight, HTA, perf, and harness workflows
  • docs/environment.md: Blackwell stack requirements, env vars, validation, and tooling

Chapter Guide

This guide captures the context, themes, and focus areas for each chapter in the book. It mirrors the narrative that previously lived in docs/chapter-guide.md.

Chapter 1: Introduction and AI System Overview

  • The AI Systems Performance Engineer
  • Benchmarking and Profiling
  • Scaling Distributed Training and Inference
  • Managing Resources Efficiently
  • Cross-Team Collaboration
  • Transparency and Reproducibility

Chapter 2: AI System Hardware Overview

  • The CPU and GPU "Superchip"
  • NVIDIA Grace CPU & Blackwell GPU
  • NVIDIA GPU Tensor Cores and Transformer Engine
  • Streaming Multiprocessors, Threads, and Warps
  • Ultra-Scale Networking
  • NVLink and NVSwitch
  • Multi-GPU Programming

Chapter 3: OS, Docker, and Kubernetes Tuning

  • Operating System Configuration
  • GPU Driver and Software Stack
  • NUMA Awareness and CPU Pinning
  • Container Runtime Optimizations
  • Kubernetes for Topology-Aware Orchestration
  • Memory Isolation and Resource Management

Chapter 4: Tuning Distributed Networking Communication

  • Overlapping Communication and Computation
  • NCCL for Distributed Multi-GPU Communication
  • Topology Awareness in NCCL
  • Distributed Data Parallel Strategies
  • NVIDIA Inference Transfer Library (NIXL)
  • In-Network SHARP Aggregation

Chapter 5: GPU-based Storage I/O Optimizations

  • Fast Storage and Data Locality
  • NVIDIA GPUDirect Storage
  • Distributed, Parallel File Systems
  • Multi-Modal Data Processing with NVIDIA DALI
  • Creating High-Quality LLM Datasets

Chapter 6: GPU Architecture, CUDA Programming, and Maximizing Occupancy

  • Understanding GPU Architecture
  • Threads, Warps, Blocks, and Grids
  • CUDA Programming Refresher
  • Understanding GPU Memory Hierarchy
  • Maintaining High Occupancy and GPU Utilization
  • Roofline Model Analysis

Chapter 7: Profiling and Tuning GPU Memory Access Patterns

  • Coalesced vs. Uncoalesced Global Memory Access
  • Vectorized Memory Access
  • Tiling and Data Reuse Using Shared Memory
  • Warp Shuffle Intrinsics
  • Asynchronous Memory Prefetching

Chapter 8: Occupancy Tuning, Warp Efficiency, and Instruction-Level Parallelism

  • Profiling and Diagnosing GPU Bottlenecks
  • Nsight Systems and Compute Analysis
  • Tuning Occupancy
  • Improving Warp Execution Efficiency
  • Exposing Instruction-Level Parallelism

Chapter 9: Increasing CUDA Kernel Efficiency and Arithmetic Intensity

  • Multi-Level Micro-Tiling
  • Kernel Fusion
  • Mixed Precision and Tensor Cores
  • Using CUTLASS for Optimal Performance
  • Inline PTX and SASS Tuning

Chapter 10: Intra-Kernel Pipelining and Cooperative Thread Block Clusters

  • Intra-Kernel Pipelining Techniques
  • Warp-Specialized Producer-Consumer Model
  • Persistent Kernels and Megakernels
  • Thread Block Clusters and Distributed Shared Memory
  • Cooperative Groups

Chapter 11: Inter-Kernel Pipelining and CUDA Streams

  • Using Streams to Overlap Compute with Data Transfers
  • Stream-Ordered Memory Allocator
  • Fine-Grained Synchronization with Events
  • Zero-Overhead Launch with CUDA Graphs

Chapter 12: Dynamic and Device-Side Kernel Orchestration

  • Dynamic Scheduling with Atomic Work Queues
  • Batch Repeated Kernel Launches with CUDA Graphs
  • Dynamic Parallelism
  • Orchestrate Across Multiple GPUs with NVSHMEM

Chapter 13: Profiling, Tuning, and Scaling PyTorch

  • NVTX Markers and Profiling Tools
  • PyTorch Compiler (torch.compile)
  • Profiling and Tuning Memory in PyTorch
  • Scaling with PyTorch Distributed
  • Multi-GPU Profiling with HTA

Chapter 14: PyTorch Compiler, XLA, and OpenAI Triton Backends

  • PyTorch Compiler Deep Dive
  • Writing Custom Kernels with OpenAI Triton
  • PyTorch XLA Backend
  • Advanced Triton Kernel Implementations

Chapter 15: Multi-Node Inference Parallelism and Routing

  • Disaggregated Prefill and Decode Architecture
  • Parallelism Strategies for MoE Models
  • Speculative and Parallel Decoding Techniques
  • Dynamic Routing Strategies

Chapter 16: Profiling, Debugging, and Tuning Inference at Scale

  • Workflow for Profiling and Tuning Performance
  • Dynamic Request Batching and Scheduling
  • Systems-Level Optimizations
  • Quantization Approaches for Real-Time Inference
  • Application-Level Optimizations

Chapter 17: Scaling Disaggregated Prefill and Decode

  • Prefill-Decode Disaggregation Benefits
  • Prefill Workers Design
  • Decode Workers Design
  • Disaggregated Routing and Scheduling Policies
  • Scalability Considerations

Chapter 18: Advanced Prefill-Decode and KV Cache Tuning

  • Optimized Decode Kernels (FlashMLA, ThunderMLA, FlexDecoding)
  • Tuning KV Cache Utilization and Management
  • Heterogeneous Hardware and Parallelism Strategies
  • SLO-Aware Request Management

Chapter 19: Dynamic and Adaptive Inference Engine Optimizations

  • Adaptive Parallelism Strategies
  • Dynamic Precision Changes
  • Kernel Auto-Tuning
  • Reinforcement Learning Agents for Runtime Tuning
  • Adaptive Batching and Scheduling

Chapter 20: AI-Assisted Performance Optimizations

  • AlphaTensor AI-Discovered Algorithms
  • Automated GPU Kernel Optimizations
  • Self-Improving AI Agents
  • Scaling Toward Multi-Million GPU Clusters

Community Resources

Monthly meetups with 100k+ members across 20+ cities:

Recent sessions:

Monthly Meetup Summaries

Contributing

Contributions are welcome! See CONTRIBUTING.md for guidelines on code, documentation, and performance improvements.

License

MIT License – see LICENSE for details.

About

No description, website, or topics provided.

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published