===========================
Quick Start
===========================

.. note:: The only major prerequisite is Java (1.8 minimum, 11 or later recommended) - Any distribution such as `Adoptium <https://adoptium.net/>`_ should work

Download and run the latest stand-alone RapidWright release jar file: `Linux <https://github.com/Xilinx/RapidWright/releases/download/v2023.1.0-beta/rapidwright-2023.1.0-standalone-lin64.jar>`_ | `Windows <https://github.com/Xilinx/RapidWright/releases/download/v2023.1.0-beta/rapidwright-2023.1.0-standalone-win64.jar>`_: 

**Linux:**

.. code-block:: bash

  wget https://github.com/Xilinx/RapidWright/releases/download/v2023.1.0-beta/rapidwright-2023.1.0-standalone-lin64.jar
  java -jar rapidwright-2023.1.0-standalone-lin64.jar

**Windows:** 

.. code-block:: bat

  curl -L -O https://github.com/Xilinx/RapidWright/releases/download/v2023.1.0-beta/rapidwright-2023.1.0-standalone-win64.jar
  java -jar rapidwright-2023.1.0-standalone-win64.jar

This will start the RapidWright `Jython <http://www.jython.org>`_ (Python 2 in Java) interpreter with most RapidWright classes loaded.  You can test your install by running the following at the prompt:

.. code-block:: python

  >>> DeviceBrowser.main([])

You should see the GUI come up similar to this screenshot:

.. image:: images/DeviceBrowser.png
	:width: 550px
	:align: center

If you have gotten to this point, congrats!  Your RapidWright install is correctly configured and you are ready to start experimenting.  

Note that the standalone jar comes pre-packaged with a few select devices:

  * AWS-F1: Virtex UltraScale+ VU9P (xcvu9p)
  * PYNQ-Z1: Zynq 7020 (xc7z020)
  * Virtex UltraScale VU440 (xcvu440)

Additional devices are downloaded over the Internet on demand when the code attempts to
load them.  See :ref:`RapidWright Data Files` for more details.