This module allows your Drupal site to connect to AI models through a self-hosted Bifrost gateway. It acts as a provider for Drupal's AI module, enabling features like chatbots and content suggestions to utilize models managed by your Bifrost instance, instead of directly connecting to individual AI vendors. This offers centralized control over AI access, costs, and vendor options.
If you're new to Drupal's AI ecosystem: the AI (Artificial Intelligence) module is the core framework other modules (AI Assistants, AI Chatbot, AI Search, and many more) use to actually talk to a language model. It doesn't call any model itself - it needs a "provider" module plugged in for whichever AI service you use. This module is that provider for Bifrost, a self-hosted gateway that sits in front of one or more AI vendors (Anthropic, OpenAI, local Ollama models, and others) behind a single, governed entry point.
In plain terms: if your organization runs its own Bifrost gateway, this module is what lets your Drupal site's AI features (chat, content suggestions, search, and anything else built on the AI module) reach the models behind that gateway, instead of each feature needing its own separate API key with its own vendor.
Features
- Registers as a standard AI Provider (
bifrost), so anywhere Drupal's AI module lets you choose a provider and model, "Bifrost" shows up as an option alongside providers like OpenAI or Anthropic. - Automatically lists whatever models your Bifrost gateway is configured to route to - there's no static list to keep updated by hand as your organization adds or changes models.
- Works with any mix of vendors behind your gateway (commercial APIs and self-hosted open models alike) through one Drupal-side configuration screen and one credential.
- Authenticates using Bifrost's own "virtual key" governance header, so budgets, rate limits, and per-key model access set up in Bifrost are respected rather than bypassed.
- Use this when: your organization already runs (or is evaluating) a self-hosted Bifrost gateway for cost control, governance, or vendor flexibility, and you want Drupal's AI-powered features to go through that gateway rather than talking to each AI vendor directly.
Post-Installation
After enabling the module, go to Configuration > AI > Providers, or directly to /admin/config/ai/providers/ai_provider_bifrost. You'll need two things, both provided by whoever manages your Bifrost gateway:
- Host - the base URL of your Bifrost deployment (including the
/v1suffix), e.g.https://bifrost.example.com/v1. - Virtual key - stored using the Key module. If you don't already have a Key entity for it, create one at
/admin/config/system/keys/addfirst, then select it on this form.
Saving the form does a live check against your gateway and will tell you right away if the host or key isn't working. Once saved, "Bifrost" becomes a selectable provider wherever the AI module is used elsewhere on your site - there's no separate content type, permission (beyond the standard "administer ai providers" permission), or additional configuration screen to visit.
Additional Requirements
- The AI (Artificial Intelligence) module - this module is a provider plugin for it and does nothing on its own.
- The Key module, to store the virtual key securely instead of in plain configuration.
- Access to a running Bifrost gateway (you or your organization must host this separately - see github.com/maximhq/bifrost) with at least one virtual key already set up there.
Recommended modules/libraries
- Whichever AI-module-based feature you actually want to use once a provider is configured - e.g. AI Assistants API or AI Chatbot for a chat interface, or AI Search / Search API AI if you want to use Bifrost-routed embedding models for site search.
Similar projects
- AI Provider LiteLLM - the closest sibling; both are thin adapters over a self-hosted, OpenAI-wire-compatible gateway. The difference: Bifrost requires its own
x-bf-vkvirtual-key header rather than a standard API key, and its model listing endpoint returns much less metadata about what each model supports, so this module relies more on heuristics (e.g. model id patterns) to sort models into chat vs. embeddings vs. other operation types. - AI Provider OpenRouter - talks to OpenRouter's own hosted API directly. Use that instead if you don't run a self-hosted gateway and are fine calling OpenRouter's cloud service directly.
Supporting this Module
No dedicated funding page at this time. The best way to support this module is through the issue queue - bug reports, feature requests, and merge requests are all welcome.
Community Documentation
- Bifrost documentation - for setting up and configuring the gateway itself (virtual keys, provider routing, budgets).
- AI (Artificial Intelligence) module documentation - for how Drupal's AI framework and its various sub-modules work once a provider (like this one) is configured.
This module's code and documentation were developed with the assistance of AI tooling (Anthropic's Claude, via Claude Code), based on the AI Provider LiteLLM module as a reference pattern. All AI-assisted output was reviewed, tested against a live Bifrost gateway, and verified by a human maintainer before release, in line with drupal.org's Policy on the use of AI when contributing to Drupal.