nodebb-plugin-ai-assistant
v1.1.2
Published
Self-hosted AI Assistant plugin for NodeBB forums with automated unprivileged bot provisioning, multi-model fallback resiliency, thread history context, Unicode/Hebrew mention parsing, RAG, and support for Gemini, Grok, Claude, OpenAI, Groq, DeepSeek, Oll
Maintainers
Readme
NodeBB AI Assistant Plugin
A powerful, self-hosted, privacy-conscious AI Assistant plugin for NodeBB forums.
Supports all major AI providers: Google Gemini, xAI Grok, Anthropic Claude, OpenAI, Groq Cloud, DeepSeek, Mistral AI, OpenRouter, Custom OpenAI-Compatible APIs, and Local Ollama.
🌟 Key Features
- Multi-Provider Support: Seamlessly connect Google Gemini, xAI Grok, Anthropic Claude, OpenAI, Groq, DeepSeek, Mistral, OpenRouter, or local self-hosted Ollama.
- Safe & Self-Hosted: No developer middleman server, no telemetry, no subscription fees. API keys are stored securely in your NodeBB database and never exposed to clients.
- Mention & Automatic Modes: Choose between
@bot_usernamemention-only responses (recommended) or automatic replies in discussions. - Admin Control Panel (ACP): Full GUI under
ACP -> Plugins -> AI Assistantto select models, customize system prompts/personas, restrict categories, and test responses in real time. - Test Playground: Built-in sandbox in ACP to verify your AI provider and prompt before enabling the bot for public users.
- Forum Context & RAG Foundation: Clean sentence chunking and keyword context retrieval with source attribution links.
- Bilingual Support: Full English and Hebrew interface and default system prompts.
🚀 Installation
Via NodeBB ACP (Recommended)
- Go to ACP -> Plugins -> Find Plugins.
- Search for
nodebb-plugin-ai-assistant. - Click Install, then Activate.
- Rebuild and restart your NodeBB forum.
Via Command Line
In your NodeBB root directory:
npm install nodebb-plugin-ai-assistant
./nodebb activate nodebb-plugin-ai-assistant
./nodebb build
./nodebb restart⚙️ Configuration
- In NodeBB ACP, navigate to Plugins -> AI Assistant.
- Select your preferred AI Provider (e.g., Google Gemini, Grok, Claude, OpenAI, Groq, DeepSeek, Ollama).
- Enter your API Key and customize the Model ID if desired.
- Customize the System Prompt / Bot Persona according to your forum's guidelines.
- Use the Test Playground at the bottom of the page to test your connection.
- Toggle Enable AI Bot in Forum (Active) and click Save.
🛡️ Privacy & Security
- Private Messages (chats) are never accessed or indexed.
- Untrusted user inputs are structurally separated from system policies.
- API keys are masked and securely retained within server settings.
📄 License
MIT License
