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.
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.
Neuron GitHub source repository: aws-neuron/torch-neuronx
NKI Compiler and Language Open Source
Source code for the NKI Compiler and the NKI languages and APIs.
Neuron GitHub source repository (NKI Compiler): aws-neuron/nki-compiler
Neuron GitHub source repository (NKI APIs): aws-neuron/nki
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
Contribute to the NKI Library: aws-neuron/nki-library
Contribute to the NKI Compiler and NKI APIs: aws-neuron/nki
Contribute the the NKI samples: aws-neuron/nki-samples