Skip to main content

Ask AI assistant widget for NPM projects

Add an AI assistant or AI search widget to your JavaScript project using Biel.ai's NPM package.

Prerequisites​

  • A Biel.ai account. If you don't have one, sign up for free.
  • A project created in your Biel.ai dashboard. Follow the Quickstart guide to create one.
  • Node.js installed.

Add the assistant widget​

Assistant widget for docs

  1. Install Biel.ai:

    npm install biel-search

  2. Make sure you embed the styles and scripts in your primary JS or entry file:

    import 'biel-search/dist/biel-search/biel-search.css';
    import 'biel-search/dist/biel-search/biel-search.esm.js';

  3. Just before the closing body tag of your website's HTML, add the following snippet:

    <biel-button project="<YOUR_PROJECT_ID>"
        header-title="Biel.ai assistant"
        button-position="bottom-right"
        modal-position="bottom-right"
        button-style="dark">
            Ask AI
    </biel-button>

    Replace <YOUR_PROJECT_ID> with your project's ID from the Biel.ai dashboard.

  4. Open the website in a web browser to verify the assistant appears and works correctly.

Select a widget version​

npm install biel-search selects the latest published release for a new installation. Your dependency range and lockfile control later installations; npm ci uses the locked version.

To select a specific release:

npm install --save-exact [email protected]

Replace 0.1.93 with your chosen release, then rebuild your application. This setting controls the installed package; see CDN version selection if your page loads scripts from jsDelivr instead.

Next steps​