Skip to main content

AI chatbot for Hugo

Here's a step-by-step guide to help you install Biel.ai in your Hugo project.

Chatbot widget for docs

Prerequisites​

Before you begin, you'll need to have the following:

  • A Biel.ai account. If you don't have one, sign up for free.
  • A project created in your Biel.ai dashboard. If you haven't created one yet, follow the steps in the Quickstart guide.
  • A Hugo project.

Installation​

To integrate the Biel.ai widget into your Hugo site:

  1. Open your terminal or command prompt. Navigate to your project's root directory using the cd command:

    cd your-hugo-site/themes/your-theme-name/

    Replace your-hugo-site with the path to your Hugo site and your-theme-name with the name of the theme you're using.

  2. Find the head partial, which is often located under layouts/partials/. Add the following code to this file:

    <!-- Initialize the Biel.ai widget -->
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/biel-search/dist/biel-search/biel-search.css">
    <script type="module" src="https://cdn.jsdelivr.net/npm/biel-search/dist/biel-search/biel-search.esm.js"></script>

  3. Next, find the footer partial (or wherever you'd like the chatbot to be placed) and add the following code just before the closing tags:

    <biel-button project="<YOUR_PROJECT_ID>" 
        header-title="Biel.ai chatbot"
        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. After making these changes, navigate back to your Hugo project root and run:

    hugo server

    Once it builds successfully, verify that the chatbot appears and functions correctly on your site.

Next steps​

For more about customization and additional features exploration, check out the customization section.

Need assistance? We're here to help! Reach out to us at Biel.ai Support.