=======
Install
=======

This chapter describes how to install icalendar as a Python package for use in your projects.


Python package with pip
-----------------------

The following command will install the icalendar package with pip.

.. code-block:: shell

    pip install icalendar

If installation is successful, you will be able to import the iCalendar package from a Python interpreter as shown.

.. code-block:: pycon

    >>> import icalendar

Distribution packages
---------------------

The icalendar package is also published in many Linux distributions.
The following badge shows where it is available, and which versions are packaged.

..  image:: https://repology.org/badge/vertical-allrepos/python%3Aicalendar.svg?columns=4
    :target: https://repology.org/project/python%3Aicalendar/versions
    :alt: Packaging status of icalendar across distributions

Repology is a service that tracks the availability and versions of packages across many Linux distributions.
`View the packaging status of icalendar across distributions <https://repology.org/project/python%3Aicalendar/versions>`_.


Debian or Ubuntu
----------------

You can install the `python-icalendar package <https://tracker.debian.org/pkg/python-icalendar>`_ for Debian or its derivatives.

.. code-block:: shell

    sudo apt-get install python3-icalendar


Arch Linux
-----------

On Arch Linux and derivatives, the package is available in the community repository.

.. code-block:: shell

    sudo pacman -S python-icalendar


Fedora
------

You can install the `python3-icalendar package <https://packages.fedoraproject.org/pkgs/python-icalendar/python3-icalendar/>`_ for Fedora or its derivatives.

.. code-block:: shell

    sudo dnf install python3-icalendar