You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 8ad8585
Browse filesBrowse the repository at this point in the historyBrowse files
Default to OpenRouter free models: Zen's free tier is API-gated
A live module returned:
AI API request failed (status 403):
OpenCode's free tier can only be used from within OpenCode
That is a deliberate provider gate, not a bad key. Zen's free tier
only answers the genuine opencode binary; the check is on User-Agent,
so every third-party HTTP client is refused even with a valid key.
Reported upstream as anomalyco/opencode#49621, after a change that
landed around 19-20 September and broke setups that had worked.
Both shipped defaults, big-pickle and space-bunny-free, are free-tier
models, so the module could not work at all as configured.
Move the defaults to OpenRouter, whose free :free variants are usable
through the documented OpenAI-compatible API:
endpoint https://openrouter.ai/api/v1/chat/completions
model qwen/qwen3.8-27b:free
fallback google/gemma-4-31b-it:free
Both verified present and priced 0/0 on the live models API, and both
accept max_tokens and temperature, which is all the module sends. The
fallback is a different family so a single provider outage does not
take out both.
No UA spoofing: overriding the User-Agent to defeat the gate would
circumvent an intentional access control and has already broken once.
Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
Copy file name to clipboardExpand all lines: README.md
+6-6Lines changed: 6 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@ A Joomla 5.4/6 site module that adds a floating **AI chat widget** to your site.
4
4
5
5
## Features
6
6
7
-
-**Grounded AI chat** — a floating chat widget backed by any OpenAI-compatible chat completions API. The default is OpenCode Zen, so a free OpenCode key is enough; point the endpoint, key and model at any other service if you prefer. Answers are grounded strictly in your site content.
7
+
-**Grounded AI chat** — a floating chat widget backed by any OpenAI-compatible chat completions API. The default is OpenRouter with a free model variant, so a free OpenRouter key is enough; point the endpoint, key and model at any other service if you prefer. Answers are grounded strictly in your site content.
8
8
-**Prompt-grounded answers** — the AI receives the articles, FAQ entries and forum topics you select as context and is instructed to answer only from that content, falling back to a configurable message when no knowledge matches. Content is used as grounding context only; the module does not render content blocks of its own.
9
9
-**You choose the knowledge base** — multi-select the article categories to draw from, point the FAQ field at your FAQ category, and opt in to Kunena forum topics with a single switch. Installing Kunena never changes what the AI can see.
10
10
-**Customizable chat UI**:
@@ -25,7 +25,7 @@ A Joomla 5.4/6 site module that adds a floating **AI chat widget** to your site.
25
25
- Joomla 5.4 or newer (Joomla 6 ready)
26
26
- PHP 8.1 or newer
27
27
- Kunena 6.x (optional, only when you switch on *Include Kunena forum topics*)
28
-
- An AI service API key (optional, only for the chat widget). With the default endpoint this is an OpenCode Zen key; any OpenAI-compatible service works if you also set the endpoint and model.
28
+
- An AI service API key (optional, only for the chat widget). With the default endpoint this is an OpenRouter key; any OpenAI-compatible service works if you also set the endpoint and model.
29
29
30
30
## Installation
31
31
@@ -52,10 +52,10 @@ See [Choosing the knowledge base content](#choosing-the-knowledge-base-content)
52
52
| Parameter | Description |
53
53
| --- | --- |
54
54
| Show AI chat widget | Enable the floating chat widget. |
55
-
| AI API key | API key for the AI service. With the default endpoint this is an OpenCode Zen key. Read on the server only; never sent to the browser. |
56
-
| AI model | Model to use, e.g. `big-pickle` (default). |
57
-
| Fallback model | Tried once if the primary request times out, is rate limited (HTTP 429) or returns a server error (HTTP 5xx); defaults to `space-bunny-free`. Leave blank to disable. |
58
-
| AI endpoint | OpenAI-compatible chat completions endpoint (defaults to OpenCode Zen). |
55
+
| AI API key | API key for the AI service. With the default endpoint this is an OpenRouter key. Read on the server only; never sent to the browser. |
56
+
| AI model | Model to use, e.g. `qwen/qwen3.8-27b:free` (default). |
57
+
| Fallback model | Tried once if the primary request times out, is rate limited (HTTP 429) or returns a server error (HTTP 5xx); defaults to `google/gemma-4-31b-it:free`. Leave blank to disable. |
58
+
| AI endpoint | OpenAI-compatible chat completions endpoint (defaults to OpenRouter). |
Copy file name to clipboardExpand all lines: language/en-GB/mod_bearsamppai.ini
+5-5Lines changed: 5 additions & 5 deletions
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
; Note: All translation files should be saved with UTF-8 encoding.
3
3
4
4
MOD_BEARSAMPPAI="Bearsampp AI"
5
-
MOD_BEARSAMPPAI_XML_DESCRIPTION="Joomla 5.4/6 ready floating AI chat widget. Answers visitor questions through an OpenAI-compatible AI API (OpenCode Zen by default), grounded in the articles, FAQ articles and Kunena forum topics you choose. Optional light/dark theme, four viewport positions, welcome message and connection indicator."
5
+
MOD_BEARSAMPPAI_XML_DESCRIPTION="Joomla 5.4/6 ready floating AI chat widget. Answers visitor questions through an OpenAI-compatible AI API (OpenRouter by default), grounded in the articles, FAQ articles and Kunena forum topics you choose. Optional light/dark theme, four viewport positions, welcome message and connection indicator."
6
6
7
7
; Content sources fieldset
8
8
MOD_BEARSAMPPAI_FIELDSET_CONTENT_LABEL="Knowledge Base Content"
MOD_BEARSAMPPAI_FIELD_SHOW_CHAT_LABEL="Show AI chat widget"
20
20
MOD_BEARSAMPPAI_FIELD_SHOW_CHAT_DESC="Enable the AI-powered chat that answers questions using the article, FAQ and forum content you select as grounding context."
21
21
MOD_BEARSAMPPAI_FIELD_AI_KEY_LABEL="AI API key"
22
-
MOD_BEARSAMPPAI_FIELD_AI_KEY_DESC="API key for the AI service. With the default endpoint this is an OpenCode Zen key. Any OpenAI-compatible service works if you also change the endpoint and model. The key is only read on the server and is never sent to the browser."
22
+
MOD_BEARSAMPPAI_FIELD_AI_KEY_DESC="API key for the AI service. With the default endpoint this is an OpenRouter key. Any OpenAI-compatible service works if you also change the endpoint and model. The key is only read on the server and is never sent to the browser."
23
23
MOD_BEARSAMPPAI_FIELD_AI_MODEL_LABEL="AI model"
24
-
MOD_BEARSAMPPAI_FIELD_AI_MODEL_DESC="Model your AI service should answer with. The default is big-pickle on OpenCode Zen. Use any model id the service accepts."
24
+
MOD_BEARSAMPPAI_FIELD_AI_MODEL_DESC="Model your AI service should answer with. The default is qwen/qwen3.8-27b:free on OpenRouter. Use any model id the service accepts."
MOD_BEARSAMPPAI_FIELD_AI_FALLBACK_MODEL_DESC="Model tried once if the primary request times out, is rate limited (HTTP 429) or returns a server error (HTTP 5xx). The default is space-bunny-free, a free OpenCode Zen model. Leave blank to disable fallback."
26
+
MOD_BEARSAMPPAI_FIELD_AI_FALLBACK_MODEL_DESC="Model tried once if the primary request times out, is rate limited (HTTP 429) or returns a server error (HTTP 5xx). The default is google/gemma-4-31b-it:free, a free OpenRouter model. Leave blank to disable fallback."
MOD_BEARSAMPPAI_FIELD_AI_ENDPOINT_DESC="OpenAI-compatible chat completions endpoint. Leave the default for OpenCode Zen, or point it at any other compatible service."
28
+
MOD_BEARSAMPPAI_FIELD_AI_ENDPOINT_DESC="OpenAI-compatible chat completions endpoint. Leave the default for OpenRouter, or point it at any other compatible service."
Copy file name to clipboardExpand all lines: language/en-GB/mod_bearsamppai.sys.ini
+1-1Lines changed: 1 addition & 1 deletion
Original file line number
Diff line number
Diff line change
@@ -2,4 +2,4 @@
2
2
; Note: All translation files should be saved with UTF-8 encoding.
3
3
4
4
MOD_BEARSAMPPAI="Bearsampp AI"
5
-
MOD_BEARSAMPPAI_XML_DESCRIPTION="Joomla 5.4/6 ready floating AI chat widget. Answers visitor questions through an OpenAI-compatible AI API (OpenCode Zen by default), grounded in the articles, FAQ articles and Kunena forum topics you choose. Optional light/dark theme, four viewport positions, welcome message and connection indicator."
5
+
MOD_BEARSAMPPAI_XML_DESCRIPTION="Joomla 5.4/6 ready floating AI chat widget. Answers visitor questions through an OpenAI-compatible AI API (OpenRouter by default), grounded in the articles, FAQ articles and Kunena forum topics you choose. Optional light/dark theme, four viewport positions, welcome message and connection indicator."
0 commit comments