This document is relevant for: Inf1, Inf2, Trn1, Trn2, Trn3
Neuron Open Source Repositories and Contribution#
AWS Neuron provides open source code and samples for some of its components, libraries, and tools under the Apache 2.0 license. The current public repositories open to contribution at this time are listed below.
Important
This page lists the AWS Neuron repositories that are currently open to contribution. For the complete list of public AWS Neuron open source projects, see the aws-neuron GitHub organization.
Neuron Open Source GitHub Repositories#
TorchNeuron PyTorch Extension Open Source
Source code for the Neuron Native PyTorch extension and the TorchNeuron library that implements it for AWS Trainium. Note: TorchNeuron is currently in private Beta. Contact your Neuron account representative to request access.
Neuron GitHub source repository: aws-neuron/torch-neuronx
Neuron Agentic Development Open Source
AI agents, skills, and agent-ready code samples for authoring, debugging, profiling, and analyzing NKI kernels inside agentic IDEs such as Claude Code and Kiro. See Neuron Agentic Development for the full feature overview.
Neuron GitHub source repository: aws-neuron/neuron-agentic-development
Neuron Kernel Library Open Source
Source code and specifications for the pre-built kernels that ship with the NKI Library .
Neuron GitHub source repository: aws-neuron/nki-library
vLLM for Neuron Open Source
Source code for the vLLM integrations with Neuron, supporting AWS Trainium and Inferentia.
Neuron GitHub source repository: vllm-project/vllm-neuron
Note: Released under vLLM project license (LICENSE).
NKI Samples
Full code examples that support NKI kernel development.
Neuron GitHub source repository: aws-neuron/nki-samples
How to Contribute to Neuron Open Source#
Contributions via pull requests are appreciated! Before sending us a pull request, please ensure that:
You are working against the latest source on the main` branch.
You check existing open and recently merged pull requests and GitHub Issues to make sure someone else hasn’t addressed the problem already.
You open a GitHub Issue for the repo to discuss any significant work.
To send us a pull request:
Fork the repository.
Modify the source; please focus on the specific change you are contributing. If you also reformat all the code, it will be hard for us to focus on your change.
Ensure local tests pass.
Commit to your fork using clear commit messages.
Send us a pull request, answering any default questions in the pull request interface.
Pay attention to any automated CI failures reported in the pull request, and stay involved in the conversation.
GitHub provides documentation on forking a repository and creating a pull request.
For the specific details on licenses and contributing to each OSS repo, review the CONTRIBUTING.md pages linked below:
Contribute to TorchNeuron: aws-neuron/torch-neuronx Note: TorchNeuron is in private Beta. Request access from your Neuron account representative.
Contribute to Neuron Agentic Development: aws-neuron/neuron-agentic-development
Contribute to the NKI Library: aws-neuron/nki-library
Contribute to the NKI samples: aws-neuron/nki-samples
This document is relevant for: Inf1, Inf2, Trn1, Trn2, Trn3