ai_workspace
You could call this Chat GPT in Drupal, or Drupal Copilot. We went with something Ai vendor agnostic: Drupal AI workspace.
It's essentially a chat GPT like interface but inside Drupal.
Warning
this module works, but is not finished yet. So only use it on production after careful consideration.
Features
AI Workspace gives every authenticated user on your Drupal site a private, persistent AI chat environment, think ChatGPT-style conversations, but self-hosted and fully integrated into your Drupal back-end. Users can open multiple named conversation threads, switch between any AI provider and model already configured in your Drupal installation, and stream responses token by token directly in the browser.
Everything is stored in Drupal entities, meaning conversations survive page reloads, are owned by the user who created them, and can be managed or deleted at any time.
- Per-user persistent threads. Each authenticated user gets their own set of conversation threads stored as Drupal entities. Threads are private and inaccessible to other users.
- Streaming responses. Answers are streamed token by token via Server-Sent Events (SSE), so users see the AI typing in real time — no waiting for the full response.
- Provider and model agnostic. Works with any AI provider configured in the Drupal AI module (OpenAI, Anthropic, Mistral, Ollama, and more). Users can switch models per thread.
- Auto-generated thread titles. After the first exchange, the AI automatically generates a short descriptive title for the conversation so users can identify threads at a glance.
- Configurable starter suggestions. Show clickable prompt suggestions on the empty-state screen to help new users get started. Fully configurable from the admin UI.
- Fully configurable appearance. The workspace name, welcome title, welcome subtitle, and page path (/ai_workspace by default) are all editable from a single settings form — no code changes required.
- React-powered SPA. The front-end is built with assistant-ui and React. It mounts into a single Drupal page and handles all interaction client-side for a fast, app-like feel.
- Clean admin integration. Appears under Administration → AI alongside other AI module settings.
When to use this module: Use AI Workspace when you want to give Drupal site users (staff, clients, members) a polished, private AI chat interface without running a separate application. Good use cases include internal knowledge assistants, customer support tooling, content drafting environments, and developer-facing Drupal helper tools.
Post-Installation
- Enable the module alongside the Drupal AI module and at least one configured AI provider.
- Visit the settings page at Administration → AI → AI Workspace (/admin/ai/ai_workspace) to:
- Set the default AI model offered to users.
- Restrict which providers users may access.
- Write a global system prompt that shapes the AI's behaviour across all conversations.
- Customise the workspace name, welcome screen text, and starter suggestions.
- Change the page path if /ai_workspace conflicts with an existing route (takes effect immediately on save, no manual cache clear needed).
- Grant permissions. Go to Administration → People → Permissions and grant the Use AI Workspace permission to the roles that should have access.
- Build the front-end bundle (for developers installing from source). The compiled React bundle is included in official releases. If you are working from the Git repository, run bash build_js.sh inside the module directory to produce js/dist/ai_workspace.js and js/dist/ai_workspace.css.
- Direct users to the workspace page (default: /ai_workspace). They can immediately create threads and start chatting.
Additional Requirements
- Drupal AI module (drupal/ai ^1.2) required. Provides the provider plugin system, model abstraction, and streaming infrastructure that AI Workspace builds on.
- At least one configured AI provider required. Without a chat-capable provider (e.g. OpenAI, Anthropic, Ollama) the workspace will display a warning and cannot process messages. Configure providers at Administration → AI → Provider Settings.
- Drupal 10.4 or 11 required.
- Node.js 20+ and npm required only when building from source. Not needed for sites installing a packaged release.
Similar projects
- AI Chat — provides a lightweight chatbot widget embeddable on any page. AI Workspace differs by offering a full-page, multi-thread, persistent workspace experience rather than a single-session embedded widget.
- AI Assistant — focuses on editor-facing AI assistance within content creation workflows. AI Workspace is user-facing and session-oriented rather than tied to the editorial experience.
Supporting this Module
AI Workspace is developed and maintained by Dropsolid AI. If you find it useful, the best way to support development is to:
- Report bugs and contribute patches on the issue queue.
- Sponsor feature development by reaching out via dropsolid.com.
Community Documentation
- Full configuration walkthrough and developer documentation: coming soon on drupal.org.
- To try the module without a local setup, a DrupalPod demo is planned for a future release.
- Questions and discussion: use the issue queue on drupal.org.