For Jekyll & GitHub Pages

Ask AI for your Jekyll site

Add an Ask AI chatbot or AI search widget to your Jekyll site. Readers ask questions in plain language and get source-cited answers from your posts and pages. Works on GitHub Pages without extra setup.

Start free trial See the install code

14-day freeSelf-serveLive in 15 min

Biel.ai chatbot

Assistant

Hi! how can I help you?

Three ways to ship Biel on Jekyll

A floating Ask AI chatbot via two include edits, an AI search field in the navbar include, or a hosted MCP endpoint Claude and Cursor can query directly. GitHub Pages compatible.

Full installation guide

Edit two `_includes`

The CDN install. Append the script tags to _includes/head.html and drop the chatbot button into _includes/footer.html. Works on the default Minima theme, just-the-docs, and any theme that exposes head/footer includes.

→Floating Ask AI button on every page
→Five button positions, dark / light / default
→GitHub Pages compatible: no plugin required
→Zero gem dependencies

_includes/footer.html

<!-- 1. In _includes/head.html append: -->

<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>

<!-- 2. In _includes/footer.html (or any include) drop in: -->

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

<!-- 3. jekyll build (or jekyll serve for local) -->

Add a search button to the navbar include

Jekyll has no native search; most sites add Lunr (via jekyll-lunr-js-search, or bundled into a theme like just-the-docs). To add an AI search field to the navbar, drop a <biel-search-button> into your header include.

→Drop-in AI search field in the navbar
→Works alongside an existing Lunr setup
→Returns synthesized answer, not a list
→Same include pattern as the chatbot

_includes/header.html

<!-- 1. In _includes/head.html append: -->

<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>

<!-- 2. In _includes/header.html, next to or in place of
        the existing search element: -->

<biel-search-button
  project="<YOUR_PROJECT_ID>"
  header-title="Documentation AI"
  button-style="rounded">
    Search
</biel-search-button>

Make your docs queryable by AI agents

Every Biel project ships with a hosted MCP endpoint. Claude, Cursor, Cline, and other MCP-compatible assistants can search your Jekyll site directly. Configure once in mcp.json.

→Hosted MCP server, no self-hosting
→Same index as the chatbot, one source of truth
→Works with Claude Desktop, Cursor, Cline, Zed
→Auth via project token, scoped per-workspace

mcp.json

{
  "mcpServers": {
    "biel-ai": {
      "name": "Biel.ai",
      "type": "http",
      "url": "https://mcp.biel.ai/v2/YOUR_PROJECT_SLUG/mcp"
    }
  }
}

Biel.ai vs Lunr on Jekyll

Jekyll has no built-in search. The de-facto default is Lunr: either via the jekyll-lunr-js-search plugin, or bundled into a theme like just-the-docs. Biel is built for natural-language questions with synthesized answers and works on plain GitHub Pages with no gem and no plugin.

Dimension	Lunr	Biel.ai
Query type	Lunr-based keyword and prefix matching, run client-side. Returns a list of pages.	Natural-language questions. Returns a synthesized answer with source citations.
GitHub Pages compatibility	GitHub Pages allows only a whitelisted set of plugins. Most search gems need a separate build step.	Pure CDN script. No gem, no plugin, no separate build. Drops into any GitHub Pages site.
Liquid and front matter	Lunr indexes the rendered HTML. It reads the result of Liquid, not the source. Front matter is invisible.	Indexes the rendered HTML the same way. Front matter is preserved as page-level metadata for citations.
Collections	Lunr indexes all collections by default. No way to scope per-collection without custom config.	Index the live site URL: collections, posts, pages, all included. Configure include / exclude per source if needed.
Multi-language	Lunr supports stemmers for around 14 languages with extra config.	Answers in 60+ languages, including languages your docs are not written in.
Analytics	Lunr does not log queries. No content-gap signal.	Unanswered questions, satisfaction trends, and a Content Gaps view that updates daily.
Install	gem install, plugin config, and an index template (or use a theme that bundles Lunr).	Two include files. Live in 15 minutes.
Cost	Free.	From $50/mo, self-serve. 14-day free trial, no credit card required.

Things teams ask during evaluation

Does it work on GitHub Pages?

Yes. The widget is a CDN-loaded web component, so it works on plain GitHub Pages without enabling any plugin gems. Drop it into _includes/head.html and _includes/footer.html and the next deploy ships it.

Will it work with our theme?

Yes. Minima, just-the-docs, jekyll-theme-cayman, and custom themes are all supported. The widget is a floating button injected via two includes; it does not depend on theme internals.

Can it index our collections and posts?

Yes. Indexing happens against the rendered HTML, so collections, posts, and pages are read together. Front matter is preserved as page-level metadata for citations.

Can we keep our existing Lunr search?

Yes. Biel sits alongside as a separate widget for natural-language questions. Many Jekyll sites run Lunr (or a theme-bundled search like just-the-docs) for keyword lookup and Biel for question-shaped queries.

What about translations and i18n?

Each language URL prefix is indexed as its own source. Citations resolve to the right localized URL. Readers can also ask in 60+ languages even if your docs only ship in English.

How long does the install take?

Two include edits and a Jekyll build. Most teams are live in 15 minutes including indexing.

Where does our content go?

EU-hosted by default. GDPR compliant. Your content is never used to train models.

Make your Jekyll site answer questions

Start free trial Book a demo

14-day free trial · No credit card required · From $50/mo

Use a different platform? See our integration pages for Docusaurus, MkDocs, Sphinx, Starlight, and Antora.