#######################
 Installing Async PRAW
#######################

Async PRAW supports Python 3.10+. The recommended way to install Async PRAW is with `uv
<https://docs.astral.sh/uv/>`_.

.. code-block:: bash

    uv add asyncpraw

Alternatively, Async PRAW can be installed via ``pip``:

.. code-block:: bash

    pip install asyncpraw

.. note::

    Depending on your system, you may need to use ``pip3`` to install packages for
    Python 3.

.. warning::

    Avoid using ``sudo`` to install packages. Do you `really` trust this package?

For instructions on installing Python and pip see "The Hitchhiker's Guide to Python"
`Installation Guides <https://docs.python-guide.org/starting/installation/>`_.

*********************
 Updating Async PRAW
*********************

Async PRAW can be updated by running:

.. code-block:: bash

    uv sync --upgrade-package asyncpraw

or with pip:

.. code-block:: bash

    pip install --upgrade asyncpraw

***************************
 Installing Older Versions
***************************

Older versions of Async PRAW can be installed by specifying the version number as part
of the installation command:

.. code-block:: bash

    uv add asyncpraw==7.1.0

or with pip:

.. code-block:: bash

    pip install asyncpraw==7.1.0

*******************************************
 Installing the Latest Development Version
*******************************************

Is there a feature that was recently merged into Async PRAW that you cannot wait to take
advantage of? If so, you can install Async PRAW directly from GitHub like so:

.. code-block:: bash

    pip install --upgrade https://github.com/praw-dev/asyncpraw/archive/main.zip

You can also directly clone a copy of the repository using git, like so:

.. code-block:: bash

    pip install --upgrade git+https://github.com/praw-dev/asyncpraw.git