.. include:: /Includes.rst.txt

.. _start:

==========================
Netresearch Browser AI
==========================

.. image:: /Images/netresearch-underline.svg
   :alt:
   :width: 200px
   :class: no-border

:Extension key:
   nr_browser_ai

:Package name:
   netresearch/nr-browser-ai

:Version:
   |release|

:Language:
   en

:Author:
   Netresearch DTT GmbH

:License:
   This document is published under the
   `CC BY 4.0 <https://creativecommons.org/licenses/by/4.0/>`__ license.

:Rendered:
   |today|

----

Netresearch Browser AI adds a frontend question-and-answer dialogue grounded in
content of the currently open page. Chrome 148 or newer runs Gemini Nano on
the visitor's device through the built-in Prompt API.

The proof of concept has no application LLM endpoint, no chat persistence and
no telemetry. A provider boundary is ready for later page-tree or whole-site
context, but the implemented scope is deliberately the current page only.

.. tip::

   A running demo is available at `netresearch.github.io/t3x-nr-browser-ai
   <https://netresearch.github.io/t3x-nr-browser-ai/>`__. It serves the
   distributable bundle and answers from the demo page's own content. Browsers
   without an on-device model see the fallback instead, which is the same path
   a visitor takes on a production site.

.. important::

   Browser built-in AI availability depends on Chrome, the desktop platform,
   hardware, storage and model state. Always configure an appropriate fallback
   or choose explicitly to render no fallback.

.. _manual-sections:

Manual sections
===============

.. card-grid::
   :columns: 1
   :columns-md: 3
   :gap: 4
   :card-height: 100

   .. card:: Administration

      Install the extension and configure the plugin, prompts and context.

      .. card-footer:: :ref:`administration`
         :button-style: btn btn-primary stretched-link

   .. card:: Browser setup

      Check Chrome requirements, download the model and run a smoke test.

      .. card-footer:: :ref:`browser-setup`
         :button-style: btn btn-primary stretched-link

   .. card:: Privacy and security

      Understand local processing, trust boundaries, CSP and responsibilities.

      .. card-footer:: :ref:`security`
         :button-style: btn btn-primary stretched-link

.. toctree::
   :hidden:
   :maxdepth: 2

   Administration/Index
   User/Index
   Security/Index

.. _manual-requirements:

Requirements
============

The extension supports TYPO3 12.4, 13.4 and 14.3 with PHP 8.2 through 8.5.
TYPO3 12.4 support is compatibility-only and requires a maintained,
security-patched distribution for production use.

The model requires Chrome 148 or newer on a supported desktop platform. See
:ref:`browser-setup-requirements` for the current Chrome requirements.

.. _manual-license:

License and support
===================

The extension is licensed under GPL-2.0-or-later. Report defects through the
`GitHub issue tracker
<https://github.com/netresearch/t3x-nr-browser-ai/issues>`__.
Report vulnerabilities privately as described in the repository's
``SECURITY.md`` file.

Developed and maintained by
`Netresearch DTT GmbH <https://www.netresearch.de/>`__.

----

.. card-grid::
   :columns: 1
   :gap: 4
   :card-height: 100

   .. card:: [n] A Netresearch extension

      .. image:: /Images/netresearch-underline.svg
         :alt:
         :width: 120px
         :class: no-border

      Professional TYPO3 development, AI integration and enterprise
      consulting since 2002.

      .. card-footer:: `netresearch.de <https://www.netresearch.de>`__
         :button-style: btn btn-secondary stretched-link