Skip to main content

AI chatbot for Sphinx

Biel.ai is an advanced chatbot designed to transform the way users interact with your technical documentation. By leveraging AI, Biel.ai delivers instant, context-rich answers, making your documentation more accessible and reducing the need for repetitive support tasks.

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

Prerequisites​

Before starting, ensure you 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. Follow the Quickstart guide to create one.
  • A Sphinx project ready to install Biel.ai.

Installation​

The Biel.ai widget enables a conversational chat powered by AI in your site.

Chatbot widget for docs

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

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

    cd path/to/your/project

    Replace path/to/your/project with your project's actual directory path.

  2. With your terminal still open, run the following command to install Biel.ai via PIP:

    pip install sphinx-biel

  3. Add the extension to your Sphinx project's conf.py file:

    extensions ['sphinx_biel']

  4. Configure your project ID in the conf.py file:

    biel_project = '<YOUR_PROJECT_ID>'
    biel_header_title = 'Biel.ai chatbot'
    biel_version = 'latest'

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

  5. Build the documentation:

    make html

    Once built, open your documentation in a web browser. verify that the chatbot appears and works correctly on your site.

Next steps​

You can customize the Biel.ai widget to suit your needs. For example, you can change the widget's position, color, and more.

To do so, you can add any of the following customization options to your conf.py file, with the following modifications:

  1. Prefix configuration options with biel_. For instance, project would be biel_project.

  2. Use underscores instead of hyphens as words separator. For example, button-position becomes biel_button_position.

Here's an example:

biel_button_style = "light"