Archived AWS Neuron SDK documentation#

Note

This page contains archived tutorials and other documentation for older versions of the AWS Neuron SDK. These pages are no longer actively maintained and may reference unsupported features or deprecated APIs. They are provided as-is and may not reflect the current state of the AWS Neuron SDK.

Overview#

The following content has been archived for reference purposes. For the latest documentation and guides, visit the AWS Neuron SDK documentation.

Archived feature docs#

Feature

Last release supported

Date archived

Neuron Profiler (archived)

Neuron 2.28.0

Archived on: 5/11/2026

TensorBoard plugin (archived)

Neuron 2.28.0 (Trn1 plugin); Neuron 2.27.0 (Inf1 plugin)

Archived on: 5/11/2026

NeuronPerf (Beta)

Neuron 2.27.0

Archived on: 12/2/2025

Helper Tools

Neuron 2.27.0

Archived on: 12/2/2025

Transformers NeuronX (transformers-neuronx)

Neuron 2.25.0

Archived on: 9/15/2025

AWS Neuron Reference for NeMo Megatron

Neuron 2.22.0

Archived on: 7/24/2026

MXNet Neuron Setup Guides

Neuron 2.27.0

Archived on: 3/30/2026

Apache MXNet Neuron — Archived

Neuron 2.16.0

Archived on: 3/11/2026

TensorFlow Neuron

Neuron 2.22.0

Archived on: 3/11/2026

PyTorch Neuron (torch-neuron) — Archived

Neuron 2.22.0

Archived on: 3/11/2026

Neuron application notes

Mixed — legacy per-component app notes

Archived on: 7/21/2026

NxD Training (NeuronX Distributed Training)

Neuron 2.32.0

Archived on: 7/24/2026

Archived deployment flows#

The following deployment flow pages were archived during the consolidation of /containers/, /devflows/, and /dlami/ into /deploy/. These pages reference legacy patterns (Inf1, Neo compilation, BYOC hosting) that have been superseded by current deployment guides.

Page

Reason archived

Date archived

Bring Your Own Neuron Container to SageMaker Hosting (Inf1) — Archived

Legacy BYOC hosting flow

Archived on: 4/20/2026

Bring Your Own Neuron Container to SageMaker Hosting (Inf2 or Trn1) — Archived

Legacy BYOC hosting flow

Archived on: 4/20/2026

Deploy on Sagemaker Hosting

Legacy SageMaker hosting flow

Archived on: 4/20/2026

Compile with Sagemaker Neo and Deploy on Sagemaker Hosting (inf1)

Legacy Neo compilation flow

Archived on: 4/20/2026

Deploy Neuron Container on Kubernetes

Superseded by EKS-specific guides

Archived on: 4/20/2026

Tutorial: Docker environment setup for Neuron Runtime 1.x

Legacy runtime 1.0

Archived on: 4/20/2026

Archived quickstarts and getting-started pages#

The following pages were archived when the quickstarts moved to the TorchNeuron, vLLM Neuron, vLLM Omni Neuron, NKI, Neuron Explorer, and Neuron Observer stack in Neuron 2.33.0. For current quickstarts, see Get started with AWS Neuron.

Page

Reason archived

Date archived

Quickstart: Train a Model on Trainium (archived)

Uses Trn1. TorchNeuron supports only Trn2 and Trn3.

Archived on: 10/13/2026

Quickstart: Run Inference on Inferentia (archived)

Uses the legacy PyTorch/XLA torch_neuronx.trace flow on Inf2

Archived on: 10/13/2026

Ask Amazon AI helper tools (archived)

Superseded by Neuron agentic development

Archived on: 10/13/2026

Archived samples, benchmarks, FAQs, and tools from About Neuron#

The following pages were moved from the About Neuron section because they describe retired instances, frameworks, or flows.

Page

Reason archived

Date archived

Model samples and tutorials

Lists samples for transformers-neuronx, NxD Training, NeMo, torch-neuron, TensorFlow Neuron, and MXNet Neuron

Archived on: 10/13/2026

Neuron performance benchmarks

Inf1, Inf2, and Trn1 benchmarks measured with retired or legacy components (TensorFlow Neuron, torch-neuron, transformers-neuronx, PyTorch/XLA, NxD Core, and NxD Training)

Archived on: 10/13/2026

Other Neuron FAQs

ONNX (torch-neuron), Inf1 inference, Inf1 troubleshooting, and Trn1 training FAQs

Archived on: 10/13/2026

Neuron Calculator

transformers-neuronx tensor parallel calculator for Inf2 and Trn1

Archived on: 10/13/2026

Neuron Custom C++ operators feature overview

Applies only to Inf2 and Trn1; NKI is the custom kernel path on Trn2 and Trn3

Archived on: 10/13/2026

Neuron Custom C++ Operators

aws-neuronx-gpsimd-customop-lib is in maintenance mode starting with Neuron 2.33 (Inf2 and Trn1 only, PyTorch/XLA path); use NKI for new custom operators

Archived on: 10/18/2026

Legacy setup#

Setup and installation guides for unsupported install targets and superseded Neuron releases have been archived. See the Archived setup guides landing page for the full list — including Rocky Linux 9, Ubuntu 20.04, and Amazon Linux 2 install targets, and previous-release PyTorch NeuronX installs (Neuron 2.7.0–2.9.0).

Archived tutorials#

Tutorial

Last release supported

Date archived

Fine-tune T5 model on Trn1

Neuron 2.24.0

Archived on: 7/31/2025

Running SSD300 with AWS Neuron

Neuron 2.24.0

Archived on: 7/31/2025

Megatron GPT Pretraining

Neuron 2.25.0

Archived on: 7/31/2025

Fine-tuning Llama2 7B with tensor parallelism and ZeRO-1 optimizer using Neuron PyTorch-Lightning

Neuron 2.26.0

Archived on: 8/25/2025

Training Llama-2-7B/13B/70B using Tensor Parallelism and Pipeline Parallelism with Neuron PyTorch-Lightning

Neuron 2.26.0

Archived on: 8/25/2025

Training CodeGen2.5 7B with Tensor Parallelism and ZeRO-1 Optimizer

Neuron 2.26.0

Archived on: 8/25/2025

Launch a GPT-3 pretraining job using neuronx-nemo-megatron

Neuron 2.26.0

Archived on: 8/25/2025

Profiling Multi-Node Training Jobs with Neuron Explorer

Neuron 2.29.0

Archived on: 3/30/2026

Profiling PyTorch NeuronX with TensorBoard (archived)

Neuron 2.28.0

Archived on: 5/11/2026

Track Training Progress in TensorBoard using PyTorch Neuron (archived)

Neuron 2.28.0

Archived on: 5/11/2026

Accessing Archived Content#

Each tutorial listed above corresponds to a specific version or feature set of the Neuron SDK that has since been superseded. Use these resources for historical context or migration guidance.

Warning

Archived tutorials may not be compatible with current Neuron SDK releases. Exercise caution when following instructions from these documents.