# Installation ## Install `Unicorn` Install `Unicorn` the same as any other Python package (preferably into a [virtual environment](https://docs.python.org/3/tutorial/venv.html)). ```shell pip install django-unicorn ``` OR ```shell poetry add django-unicorn ``` ```{note} If attempting to install `django-unicorn` and `orjson` is preventing the installation from succeeding, check whether it is using 32-bit Python. Unfortunately, `orjson` is only supported on 64-bit Python. More details in [issue #105](https://github.com/adamghill/django-unicorn/issues/105). ``` ## Integrate `Unicorn` with Django 1\. Add `"django_unicorn",` to the `INSTALLED_APPS` array in the Django settings file (normally `settings.py`) ```python # settings.py INSTALLED_APPS = ( # other apps "django_unicorn", ) ``` 2\. Add `path("unicorn/", include("django_unicorn.urls")),`into the project's`urls.py` ```python # urls.py urlpatterns = ( # other urls path("unicorn/", include("django_unicorn.urls")), ) ``` 3\. Add `{% load unicorn %}` to the top of the Django HTML template 4\. Add `{% unicorn_scripts %}` and `{% csrf_token %}` into a Django HTML template ```html {% load unicorn %} {% unicorn_scripts %} {% csrf_token %} ``` Then, [create a component](components.md).