.. _setup-ubuntu22-multi-framework-dlami:

.. card:: Select a Different Framework or Platform for Setup
    :link: setup-guide-index
    :link-type: ref
    :class-body: sphinx-design-class-title-small


Get Started with Neuron on Ubuntu 22 with Neuron Multi-Framework DLAMI
======================================================================

You can quickly get started on Ubuntu 22 using the Neuron Deep Learning AMI (DLAMI). Then, start using one of the multiple frameworks or libraries that Neuron SDK supports by
activating the corresponding virtual environment. Each virtual environment comes pre-installed with Neuron libraries needed for you to get started. The Neuron DLAMI supports all Neuron instances (Inf1/Inf2/Trn1/Trn1n)
and is updated with each Neuron SDK release. To start using the latest version of the Neuron DLAMI, use the following steps:

Step 1:  Launch the instance using Neuron DLAMI
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Once you open the `EC2 Console <https://console.aws.amazon.com/ec2>`_, select your desired AWS region and choose "Launch Instance". Under AMI selection select the "Quick Start"
and "Ubuntu", choose the "Deep Learning AMI Neuron (Ubuntu 22.04)"(see screenshot below). Once you have selected the AMI, select the desired Neuron Instance(Inf1/Inf2/Trn1/Trn1n) , 
configure disk size and other criteria, launch the instance

.. image:: /images/neuron-multi-framework-dlami-quick-start.png
    :scale: 20%
    :align: center


.. note::
  If you are looking to use the Neuron DLAMI in your cloud automation flows , Neuron also supports :ref:`SSM parameters <ssm-parameter-neuron-dlami>` to easily retrieve the latest DLAMI id.



Step 2: Activate the desired virtual environment 
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^  

You can activate one of the virtual environments below depending on the library or framework you are interested in.

.. list-table::
    :widths: 20 39 
    :header-rows: 1
    :align: left
    :class: table-smaller-font-size

    * - Neuron Framework/Library
      - Activate Virtual Environment Instruction

    * - PyTorch Neuron 2.1 (Torch NeuronX , NeuronX Distributed)
      - .. code-block::
           
           source /opt/aws_neuronx_venv_pytorch_2_1/bin/activate

    * - PyTorch Neuron 1.13.1 (Torch NeuronX , NeuronX Distributed)
      - .. code-block::
       
           source /opt/aws_neuronx_venv_pytorch_1_13/bin/activate

    * - Transformers NeuronX (PyTorch 2.1)
      - .. code-block::
  
           source /opt/aws_neuronx_venv_transformers_neuronx/bin/activate

    * - Tensorflow Neuron 2.10 (Tensorflow NeuronX)
      - .. code-block::
  
           source /opt/aws_neuronx_venv_tensorflow_2_10/bin/activate

    * - PyTorch Neuron 1.13.1 (Inf1) (Torch Neuron) 
      - .. code-block::
  
           source /opt/aws_neuron_venv_pytorch_1_13_inf1/bin/activate

    * - Tensorflow 2.10 (Inf1) (Tensorflow Neuron) 
      - .. code-block::
  
           source /opt/aws_neuron_venv_tensorflow_2_10_inf1/bin/activate



After you have activated the desired virtual environment , you can try out one of the tutorials listed in the corresponding framework or library training and inference section.