AI chat widget for Sphinx
Add an AI chatbot to your Sphinx documentation using Biel.ai's Python package. The integration works with any Sphinx theme, including Read the Docs, and adds both chat and search capabilities.
This guide shows you how to install the package via pip and add the chat widget to your Sphinx site in minutes.
Prerequisites
Before starting, ensure you have::
- 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 chat widget enables a conversational chat powered by AI in your site.
To integrate the Biel.AI chat widget into your Sphinx site:
-
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. -
With your terminal still open, run the following command to install Biel.ai via PIP:
pip install sphinx-biel
-
Add the extension to your Sphinx project's
conf.py
file:extensions ['sphinx_biel']
-
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. -
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 chat 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:
-
Prefix configuration options with
biel_
. For instance,project
would bebiel_project
. -
Use underscores instead of hyphens as words separator. For example,
button-position
becomesbiel_button_position
.
Here's an example:
biel_button_style = "light"