NVIDIA Aerial™ Framework

A real-time signal processing framework

The Aerial Framework has been designed from the ground up to meet the needs of 3GPP Radio Access Networks — signal processing workloads with microsecond latency requirements. It is a single platform that unites research, testbeds, and production deployments to solve development challenges for real-time applications.

Features

• ⚡ Python → Real-time – Prototype in Python and lower to high-performance GPU code.
• 🍱 Clean separation – Decouple signal-processing algorithm development from runtime execution.
• 🧩 Modular pipelines – Compose end-to-end pipelines from compiled, executable modules.
• 🔭 Observability built-in – Hooks for profiling and monitoring throughout development.
• 🔁 One codebase – Reuse components for prototyping, simulation, testing, and deployment.
• 🚀 Modern toolchain – Python 3.12+, C++20, CUDA 12.9, CMake, JAX, PyTorch, uv, ruff.
• 💻 Developer-friendly – Prototype on local machines and scale to live, production deployments.
• 📚 Guided tutorials – Jupyter notebooks ready to run in a Docker container.
• 🤖 Targets 5GAdv & 6G – Ships with an example AI-native PUSCH Pipeline. More to come.

How It Works

The Aerial Framework combines two components:

• Developer tools: Tools to convert Python/JAX/PyTorch and C++/CUDA into pipelines of GPU-native code
• Runtime engine: Coordinates the execution of GPU pipelines with network interfaces

Aerial Framework Developer Tools

• JAX → TensorRT – Export JAX programs to StableHLO and lower to TensorRT engines using MLIR-TensorRT
• Multi-language – Author algorithms in JAX, PyTorch, or C++/CUDA and deploy to common runtime engine
• Modern Profiling – Leverage NVIDIA Nsight Systems to optimize pipelines and individual kernels to μs-level
• AI native – Seamlessly integrate with AI Frameworks allowing end-to-end differentiability

Aerial Framework Runtime

• CUDA graphs – GPU operations run as CUDA graphs with TensorRT integration for deterministic execution
• Task scheduler – Pinned, high-priority threads on isolated CPU cores enforce microsecond slot timing
• Inline GPU networking – DOCA GPUNetIO and GPUDirect RDMA enable zero-copy packet transfer NIC ↔ GPU
• Production driver – Orchestrates pipelines, memory pools & multi-cell coordination

Development → Deployment Workflow

Aerial Framework supports two different environments depending on your use case.

Development - Developers prototype and optimize their algorithms in Python and then compile to GPU native code using MLIR-TensorRT. This is accessible to any developer with a recent GPU (compute capability ≥ 8).

Runtime - Deployments run compiled TensorRT engines with deterministic scheduling and high-performance networking. Testing requires a GPU, NIC, and real-time kernel to validate that pipelines meet latency constraints using Medium Access Control (MAC) and Radio Unit (RU) emulation.

This approach bridges:

• Development Productivity - Write in high-level languages with rich ecosystems
• Runtime Performance - Execute with the speed and determinism of optimized C++
• Low Latency Requirements - Meet strict timing and latency constraints

Quickstart

Install the Docker container, then explore and build from source:

# 1) Configure (release preset)
cmake --preset clang-release

# 2) Build
cmake --build out/build/clang-release

# 3) Install Example Python Package - 5G RAN
cd ran/py && uv sync

Documentation & Tutorials

Documentation is available at: docs.nvidia.com/aerial/framework

Get started with step-by-step Tutorials.

Tutorial	Summary
Getting Started	Set up Docker, verify GPU access, build the project, and run tests.
PUSCH Receiver	Build a reference PUSCH receiver in NumPy with inner/outer receiver blocks.
MLIR-TensorRT	Compile JAX functions (FIR filter example) to TensorRT engine(s).
Lowering PUSCH	Compile complete PUSCH inner receiver to TensorRT and benchmark with Nsight.
AI Channel Filter	Train a neural network to dynamically estimate channel filter parameters.
Channel Filter Design	Design custom JAX channel estimators, lower to TensorRT, and profile with Nsight.
Full PUSCH Pipeline	Run complete pipeline mixing TensorRT engines and CUDA C++ kernels.
Fronthaul Testing	O-RAN fronthaul with DOCA GPUNetIO, task scheduling, and RU emulator.
PHY Integration	Full PHY application with MAC and RU emulators for integration testing.

NVIDIA AI Aerial™

NVIDIA Aerial™ Framework is a part of NVIDIA AI Aerial™, a portfolio of accelerated computing platforms, software and tools to build, train, simulate, and deploy AI-native wireless networks. Learn more in AI Aerial™ Documentation.

The following AI Aerial™ software is available as open source:

• NVIDIA Aerial™ Framework (this repository)
• NVIDIA Aerial™ CUDA-Accelerated RAN

Visit the NVIDIA 6G Developer Program for software releases, 6G events and technical training for AI Aerial™.

License

Aerial Framework is licensed under the Apache 2.0 license. See LICENSE for details. Some dependencies may have different licenses. See ATTRIBUTION for third-party attributions in the source repository.