The module uses Retrieval-Augmented Generation (RAG) — a pattern that grounds AI responses in your actual content rather than the model's training data to help discoverability and increase usage of your collections.
Four ways to add it to a site
The module offers four integration points, each suited to different use cases:
Global floating widget: Enabled site-wide from the module's admin settings. A circular button appears fixed to the bottom-right corner of every public page. Clicking it opens a slide-up chat panel. The heading is configurable ("Ask our collection" by default). This is the lowest-friction option: zero page editing required.
Semantic Search page: A dedicated full-page search experience at /s/:site-slug/search, wired up as a navigation link type so it can be added to the site's menu like any other page. It renders a full-width search interface powered by the same vector index, returning ranked results rather than a conversational response — closer to a "smart search" than a chatbot. Good for sites where you want semantic search to be a first-class destination.
Semantic Search block: The same vector search experience as above, but as an inline page block you can drop into any existing site page. Configurable per-block: custom heading, placeholder text, results per page, and optionally restricted to specific item sets.
Chatbot block: An inline conversational chat interface (not search results) that can be embedded on any page. Like the global widget but scoped to a single page, with per-block overrides for the system prompt, heading, and item set filtering. Useful for context-specific bots — a "Ask about this exhibition" panel on a collection page, for instance.
Mar 17, 2026
Adds a collection-aware AI chatbot to your Omeka S installation. Visitors can ask natural-language questions and receive answers grounded in your collection, with numbered citations linking back to source items.
Highlights:
- RAG-powered answers — uses OpenAI embeddings and Turso vector search to retrieve relevant content before generating a response
- Flexible display — embed an inline chat interface on any site page via a block layout, or enable a floating chat button across all public pages
- Auto-indexing — items, media, and blog posts are automatically re-indexed when created or updated
- Per-block customization — each chatbot block can have its own heading, system prompt, anonymous access setting, and item set filter
- Admin tools — bulk re-index, live diagnostics, connection testing, and a filterable log viewer
- Secure — API keys are AES-256-CBC encrypted at rest; all OpenAI calls are server-side; public chat endpoint is rate-limited to 10 requests per 60 seconds per IP
- Requires PHP 8.1+, Omeka S 4.0+, an OpenAI account, and a Turso database
/ yearly