.. _oobe:

Out of the Box Experience
--------------------------

The Modalix DevKit ships with two demo applications preloaded and ready to run — no installation or SDK setup required. This is the fastest way to experience SiMa's platform.

.. image:: ../../media/OOB.png
   :alt: Out of the Box demo portal landing page
   :align: center
   :width: 80%

.. raw:: html

   <br><br>

.. list-table::
   :widths: 30 70
   :header-rows: 1

   * - Demo
     - Description
   * - `Multichannel Vision AI <run_demos.html#multichannel-vision-ai-demo>`_
     - Real-time processing of 16 simultaneous video streams with object detection and pose estimation models (YOLOv9s, YOLOv8, YOLOv7).
   * - `LLiMa (GenAI) <run_demos.html#vlm-demo>`_
     - Multimodal large language model demo powered by Gemma 3, supporting text, image, and voice input with RAG support.

----

**Prerequisites**

- Modalix DevKit powered on and connected to a network.
- A computer on the same network with a Chrome browser.
- The DevKit's IP address — find it using one of the methods below.

.. dropdown:: How to find the DevKit IP address
   :animate: fade-in
   :color: secondary

   **From the serial console**, run:

   .. code-block:: console

      davinci:~$ ip a | grep inet

   Look for the ``inet`` address on the ``end0`` interface, for example ``192.168.91.181``.

   **From the host machine**, scan the local subnet using ``nmap``:

   .. code-block:: console

      sima-user@sima-user-machine:~$ nmap -sn 192.168.1.0/24 | grep report

   Replace ``192.168.1.0/24`` with your actual subnet. The DevKit will appear as one of the discovered hosts.

   For full network configuration options, see :ref:`setup_standalone_network_cfg`.

----

**Launch the Demo Portal**

Open Chrome on your computer and navigate to:

.. code-block:: text

   http://<modalix-ip>:8800

The demo portal will load and present both available demos. Select the one you want to try.

.. note::

   If the portal does not load, verify the DevKit is powered on and reachable. You can test connectivity by pinging the DevKit's IP address from the host machine.

----

**Reinstall or Update**

If the DevKit has been wiped, reflashed, or the preloaded demos are missing, run the OOB setup script directly on the DevKit:

.. code-block:: bash

   modalix:~$ cd /tmp && curl -O https://tools.modalix.info/setup-oob.sh && bash setup-oob.sh

Connect the DevKit to the Internet first (via SSH or serial console). If a previous OOB version is detected, the script prompts for upgrade confirmation — type ``Yes``. Installation requires authorization: the script prints a code and an ``auth.sima.ai`` URL — open the URL in a browser, log in with your developer portal credentials, and confirm the code.

For advanced setups (live RTSP from a host, rebuilding a demo from source, or RAG File Processing Server), follow the per-demo instructions on the :ref:`hello_sima_run_demos` page:

- `Multichannel Vision AI demo <run_demos.html#multichannel-vision-ai-demo>`_ — host RTSP setup, pipeline install, and OptiView setup.
- `VLM demo <run_demos.html#vlm-demo>`_ — LLiMa install on the Modalix DevKit, with optional RAG File Processing Server setup.