Skip to content

Open-source AI browser agent for Chrome and Firefox (monorepo) 🧠

feat(providers): add Freebuff2API integration

Codex release-state testf625741be34c
diff --git a/docs/providers-and-models.md b/docs/providers-and-models.md
index f38668ae8..897cf5135 100644
--- a/docs/providers-and-models.md
+++ b/docs/providers-and-models.md
@@ -119,17 +119,17 @@ class BaseLLMProvider {
### Extended provider catalog
-WebBrain also ships 80 disabled-by-default provider cards. Most are sourced
+WebBrain also ships 81 disabled-by-default provider cards. Most are sourced
from the OpenCode provider catalog snapshot at commit
`62e4641235d7847dadc60da37cca8a023dd54fc1`; provider-specific additions use
their official API documentation. Together with the original cards, Settings
-contains **113 built-in providers on Chromium** and **112 on Firefox**; the
+contains **114 built-in providers on Chromium** and **113 on Firefox**; the
difference is the Chromium-only in-browser WebGPU runtime.
| IDs |
|---|
| `302ai`, `abacus`, `aihubmix`, `alibaba-coding-plan`, `alibaba-coding-plan-cn`, `azure-cognitive-services`, `bailing`, `baseten`, `berget`, `cerebras`, `chutes`, `clarifai`, `cloudferro-sherlock`, `cohere`, `cortecs`, `deepinfra`, `demonroute`, `digitalocean`, `dinference`, `drun`, `evroc`, `fastrouter`, `friendli` |
-| `google-vertex`, `google-vertex-anthropic`, `helicone`, `iflowcn`, `inception`, `inference`, `io-net`, `jiekou`, `kilo`, `kimi-for-coding`, `kuae-cloud-coding-plan`, `llama`, `lucidquery`, `meganova`, `minimax-cn-coding-plan`, `minimax-coding-plan`, `moark`, `modelscope`, `morph` |
+| `freebuff2api`, `google-vertex`, `google-vertex-anthropic`, `helicone`, `iflowcn`, `inception`, `inference`, `io-net`, `jiekou`, `kilo`, `kimi-for-coding`, `kuae-cloud-coding-plan`, `llama`, `lucidquery`, `meganova`, `minimax-cn-coding-plan`, `minimax-coding-plan`, `moark`, `modelscope`, `morph` |
| `nano-gpt`, `nearai`, `nebius`, `nova`, `novita-ai`, `ollama-cloud`, `opencode`, `opencode-go`, `orcarouter`, `ovhcloud`, `perplexity`, `perplexity-agent`, `poe`, `pollinations`, `privatemode-ai`, `qihang-ai`, `qiniu-ai`, `requesty`, `scaleway`, `siliconflow`, `siliconflow-cn`, `stackit` |
| `stepfun`, `submodel`, `synthetic`, `tencent-coding-plan`, `upstage`, `v0`, `venice`, `vercel`, `vivgrid`, `vultr`, `wandb`, `xiaomi`, `zai-coding-plan`, `zenmux`, `zhipuai`, `zhipuai-coding-plan` |
@@ -148,6 +148,22 @@ Morph and standard Perplexity Sonar are text-only integrations in the agent
and advertise `supportsTools: false`. New provider cards remain inactive until
the user saves their credentials and selects the provider.
+#### Freebuff2API
+
+[Freebuff2API](https://github.com/Quorinex/Freebuff2API) is a self-hosted,
+OpenAI-compatible proxy. Start the server, then configure the **Freebuff2API
+(Local)** card with its URL (the default is `http://127.0.0.1:8080/v1`) and
+select a model with **Load Models**. Enter a proxy API key only when its
+`API_KEYS` access control is enabled; Freebuff authentication tokens remain on
+the proxy server and are never entered into WebBrain.
+
+#### IO.NET and Synthetic
+
+[IO.NET](https://io.net/docs/guides/intelligence/io-intelligence) and
+[Synthetic](https://synthetic.new/) are built-in OpenAI-compatible cloud
+providers. Add each service's bearer API key in its Settings card, choose a
+model, save, and select the provider.
+
#### NEAR AI Cloud
[NEAR AI Cloud](https://cloud.near.ai/) exposes an OpenAI-compatible API at
diff --git a/package.json b/package.json
index 88888ce6d..6a9565bee 100644
--- a/package.json
+++ b/package.json
@@ -5,11 +5,12 @@
"private": true,
"type": "module",
"scripts": {
-"test": "npm run test:cms && npm run test:markdown && npm run test:systemone && npm run test:systemone:fast && node --test test/browser-dialogs.mjs test/capsolver-cloud-broker.mjs test/captcha-providers.mjs test/captcha-weighted-fallback.mjs test/captcha-hcaptcha-providers.mjs test/captcha-native-providers.mjs test/captcha-runtime-policy.mjs test/captcha-callback-bridge.mjs test/captcha-aws-recovery.mjs test/captcha-documented-contracts.mjs test/huggingface-signup-recovery.mjs test/trace-full-export.mjs && npm run test:firefox-bidi && npm run test:runtime-lifecycle && npm run test:billing-notice && npm run test:provider-limits && npm run test:openrouter-capabilities && npm run test:accessibility-tree-benchmark && npm run test:toolbar-guard && npm run test:cloud-bridge-approval && npm run test:discord && npm run test:pdf-read && npm run test:pdf-selection && npm run test:social-contract && npm run test:safesocial && npm run test:build-unpacked && npm run test:attachment-drop && npm run test:workflow-editor && node --test test/profile-sync-stats.mjs && node --test test/memcode-recall.mjs && node test/run.js && node test/selection-scope-restoration.mjs && node scripts/benchmark-offline-relevance.mjs && npm run test:security",
+"test": "npm run test:cms && npm run test:markdown && npm run test:systemone && npm run test:systemone:fast && node --test test/browser-dialogs.mjs test/capsolver-cloud-broker.mjs test/captcha-providers.mjs test/captcha-weighted-fallback.mjs test/captcha-hcaptcha-providers.mjs test/captcha-native-providers.mjs test/captcha-runtime-policy.mjs test/captcha-callback-bridge.mjs test/captcha-aws-recovery.mjs test/captcha-documented-contracts.mjs test/huggingface-signup-recovery.mjs test/trace-full-export.mjs && npm run test:firefox-bidi && npm run test:runtime-lifecycle && npm run test:billing-notice && npm run test:provider-limits && npm run test:provider-catalog && npm run test:openrouter-capabilities && npm run test:accessibility-tree-benchmark && npm run test:toolbar-guard && npm run test:cloud-bridge-approval && npm run test:discord && npm run test:pdf-read && npm run test:pdf-selection && npm run test:social-contract && npm run test:safesocial && npm run test:build-unpacked && npm run test:attachment-drop && npm run test:workflow-editor && node --test test/profile-sync-stats.mjs && node --test test/memcode-recall.mjs && node test/run.js && node test/selection-scope-restoration.mjs && node scripts/benchmark-offline-relevance.mjs && npm run test:security",
"test:captcha:ui": "node test/captcha-settings-ui.mjs && node test/captcha-application-ui.mjs",
"test:captcha:bridge:ui": "node test/captcha-callback-bridge-ui.mjs",
"test:billing-notice": "node test/billing-payment-notice.mjs",
"test:provider-limits": "node test/provider-model-limits.mjs",
+ "test:provider-catalog": "node test/provider-catalog-integrations.mjs",
"test:openrouter-capabilities": "node --test test/openrouter-model-capabilities.mjs test/muse-tool-choice.mjs",
"test:markdown": "node --test test/markdown-render.mjs",
"test:accessibility-tree-benchmark": "node --test test/llm/lib/accessibility-tree-formats.test.mjs && node test/llm/accessibility-tree-benchmark.mjs --no-exact-tokenizer --check",
diff --git a/src/chrome/icons/providers/SOURCES.md b/src/chrome/icons/providers/SOURCES.md
index c7bf6b76c..eecd0ed5e 100644
--- a/src/chrome/icons/providers/SOURCES.md
+++ b/src/chrome/icons/providers/SOURCES.md
@@ -11,7 +11,7 @@ Most brand marks come from [Lobe Icons](https://github.com/lobehub/lobe-icons)
| osaurus | [Osaurus official logo](https://github.com/osaurus-ai/osaurus/blob/main/App/osaurus/Assets.xcassets/osaurus-logo.imageset/osaurus-logo-black.svg) (`osaurus-ai/osaurus`, MIT) |
| localai | LocalAI official logo (`mudler/LocalAI`) |
| gpt4all | Simple mark (not an official GPT4All brand asset) |
-| local_openai_proxy, webgpu | WebBrain-authored generic local-runtime marks |
+| local_openai_proxy, webgpu, freebuff2api | WebBrain-authored generic local-runtime marks |
| ods | [Official ODS product logo](https://osmantic.com/assets/images/products/ods-logo.png) (Osmantic) |
| unsloth | Unsloth official `images/unsloth logo only.png` (`unslothai/unsloth`), vectorized |
| sglang | SGLang official `logo_square` (`sgl-project/sglang`) |
diff --git a/src/chrome/icons/providers/freebuff2api.svg b/src/chrome/icons/providers/freebuff2api.svg
new file mode 100644
index 000000000..80c3eca2a
--- /dev/null
+++ b/src/chrome/icons/providers/freebuff2api.svg
@@ -0,0 +1,3 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" role="img" aria-label="Freebuff2API">
+ <path fill="currentColor" d="M3 3h11a5 5 0 0 1 0 10H8v8H3V3Zm5 5h6a1 1 0 0 0 0-2H8v2Zm0 9h7a3 3 0 0 1 0 6H3v-6h5Zm0 3h7a1 1 0 0 0 0-2H8v2Z"/>
+</svg>
diff --git a/src/chrome/src/providers/manager.js b/src/chrome/src/providers/manager.js
index d02928de8..ca7edf836 100644
--- a/src/chrome/src/providers/manager.js
+++ b/src/chrome/src/providers/manager.js
@@ -79,7 +79,7 @@ import {
const WEBBRAIN_CLOUD_PROVIDER_ID = 'webbrain_cloud';
const WEBBRAIN_CLOUD_PROVIDER_LABEL = 'WebBrain Compass';
const DUPLICATE_PROVIDER_SUFFIX = '__duplicate';
-const LOCAL_MODEL_LIST_PROVIDER_IDS = ['llamacpp', 'ollama', 'ods', 'lmstudio', 'osaurus', 'jan', 'vllm', 'sglang', 'localai', 'gpt4all', 'local_openai_proxy', 'unsloth'];
+const LOCAL_MODEL_LIST_PROVIDER_IDS = ['llamacpp', 'ollama', 'ods', 'lmstudio', 'osaurus', 'jan', 'vllm', 'sglang', 'localai', 'gpt4all', 'local_openai_proxy', 'unsloth', 'freebuff2api'];
const WEBBRAIN_CLOUD_CONTEXT_WINDOW = 1000000;
const WEBBRAIN_CLOUD_LEGACY_CONTEXT_WINDOW = 256000;
const WEBBRAIN_DEVICE_GUID_KEY = 'webbrainDeviceGuid';
diff --git a/src/chrome/src/providers/provider-catalog.js b/src/chrome/src/providers/provider-catalog.js
index 3f92e3bbf..a2014ac2e 100644
--- a/src/chrome/src/providers/provider-catalog.js
+++ b/src/chrome/src/providers/provider-catalog.js
@@ -82,6 +82,7 @@ const PROVIDERS = [
provider('drun', 'D.Run (China)', 'https://chat.d.run/v1', 'public/deepseek-v3', 131072, { apiKeyUrl: 'https://www.d.run', inputCostPerMillionUsd: 0.28, outputCostPerMillionUsd: 1.1 }),
provider('evroc', 'evroc', 'https://models.think.evroc.com/v1', 'moonshotai/Kimi-K2.6', 262144, { apiKeyUrl: 'https://docs.evroc.com/products/think/overview.html', supportsVision: true, inputCostPerMillionUsd: 1.4375, outputCostPerMillionUsd: 5.75 }),
provider('fastrouter', 'FastRouter', 'https://go.fastrouter.ai/api/v1', 'moonshotai/kimi-k2', 131072, { apiKeyUrl: 'https://fastrouter.ai/models', inputCostPerMillionUsd: 0.55, outputCostPerMillionUsd: 2.2 }),
+ provider('freebuff2api', 'Freebuff2API (Local)', 'http://127.0.0.1:8080/v1', '', 16384, { category: 'local', apiKeyUrl: 'https://github.com/Quorinex/Freebuff2API', requiresModel: true, apiKeyPlaceholder: 'Optional proxy API key' }),
provider('friendli', 'Friendli', 'https://api.friendli.ai/serverless/v1', 'google/gemma-4-31B-it', 262144, { apiKeyUrl: 'https://friendli.ai/docs/guides/serverless_endpoints/introduction', supportsVision: true, inputCostPerMillionUsd: 0.14, outputCostPerMillionUsd: 0.4 }),
provider('google-vertex', 'Google Vertex AI', 'https://{vertex_endpoint}/v1/projects/{project}/locations/{location}/endpoints/openapi', 'gemini-3.7-flash', 1048576, { category: 'cloud', apiKeyUrl: 'https://console.cloud.google.com/apis/credentials', apiKeyHeader: 'x-goog-api-key', project: '', location: 'us-central1', supportsVision: true, apiKeyPlaceholder: 'Google authorization key', suggestions: ['gemini-3.1-pro', 'gemini-3.7-flash', 'gemini-3.6-flash', 'gemini-3.5-flash'] }),
provider('google-vertex-anthropic', 'Google Vertex AI (Anthropic)', 'https://{vertex_endpoint}', 'claude-sonnet-5', 1000000, { category: 'cloud', type: 'vertex_anthropic', apiKeyUrl: 'https://console.cloud.google.com/apis/credentials', project: '', location: 'us-east5', supportsVision: true, inputCostPerMillionUsd: 2, cacheReadCostPerMillionUsd: 0.2, cacheWriteCostPerMillionUsd: 2.5, outputCostPerMillionUsd: 10, apiKeyPlaceholder: 'Google authorization key', suggestions: ['claude-opus-5', 'claude-sonnet-5', 'claude-haiku-4-5@20251001'] }),
diff --git a/src/firefox/icons/providers/SOURCES.md b/src/firefox/icons/providers/SOURCES.md
index 30a148992..3904f161f 100644
--- a/src/firefox/icons/providers/SOURCES.md
+++ b/src/firefox/icons/providers/SOURCES.md
@@ -11,7 +11,7 @@ Most brand marks come from [Lobe Icons](https://github.com/lobehub/lobe-icons)
| osaurus | [Osaurus official logo](https://github.com/osaurus-ai/osaurus/blob/main/App/osaurus/Assets.xcassets/osaurus-logo.imageset/osaurus-logo-black.svg) (`osaurus-ai/osaurus`, MIT) |
| localai | LocalAI official logo (`mudler/LocalAI`) |
| gpt4all | Simple mark (not an official GPT4All brand asset) |
-| local_openai_proxy | WebBrain-authored generic proxy mark |
+| local_openai_proxy, freebuff2api | WebBrain-authored generic proxy marks |
| ods | [Official ODS product logo](https://osmantic.com/assets/images/products/ods-logo.png) (Osmantic) |
| unsloth | Unsloth official `images/unsloth logo only.png` (`unslothai/unsloth`), vectorized |
| sglang | SGLang official `logo_square` (`sgl-project/sglang`) |
diff --git a/src/firefox/icons/providers/freebuff2api.svg b/src/firefox/icons/providers/freebuff2api.svg
new file mode 100644
index 000000000..80c3eca2a
--- /dev/null
+++ b/src/firefox/icons/providers/freebuff2api.svg
@@ -0,0 +1,3 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" role="img" aria-label="Freebuff2API">
+ <path fill="currentColor" d="M3 3h11a5 5 0 0 1 0 10H8v8H3V3Zm5 5h6a1 1 0 0 0 0-2H8v2Zm0 9h7a3 3 0 0 1 0 6H3v-6h5Zm0 3h7a1 1 0 0 0 0-2H8v2Z"/>
+</svg>
diff --git a/src/firefox/src/providers/manager.js b/src/firefox/src/providers/manager.js
index b5e01b51c..f3066b1d0 100644
--- a/src/firefox/src/providers/manager.js
+++ b/src/firefox/src/providers/manager.js
@@ -53,7 +53,7 @@ import {
const WEBBRAIN_CLOUD_PROVIDER_ID = 'webbrain_cloud';
const WEBBRAIN_CLOUD_PROVIDER_LABEL = 'WebBrain Compass';
const DUPLICATE_PROVIDER_SUFFIX = '__duplicate';
-const LOCAL_MODEL_LIST_PROVIDER_IDS = ['llamacpp', 'ollama', 'ods', 'lmstudio', 'osaurus', 'jan', 'vllm', 'sglang', 'localai', 'gpt4all', 'local_openai_proxy', 'unsloth'];
+const LOCAL_MODEL_LIST_PROVIDER_IDS = ['llamacpp', 'ollama', 'ods', 'lmstudio', 'osaurus', 'jan', 'vllm', 'sglang', 'localai', 'gpt4all', 'local_openai_proxy', 'unsloth', 'freebuff2api'];
const WEBBRAIN_CLOUD_CONTEXT_WINDOW = 1000000;
const WEBBRAIN_CLOUD_LEGACY_CONTEXT_WINDOW = 256000;
const WEBBRAIN_DEVICE_GUID_KEY = 'webbrainDeviceGuid';
diff --git a/src/firefox/src/providers/provider-catalog.js b/src/firefox/src/providers/provider-catalog.js
index 3f92e3bbf..a2014ac2e 100644
--- a/src/firefox/src/providers/provider-catalog.js
+++ b/src/firefox/src/providers/provider-catalog.js
@@ -82,6 +82,7 @@ const PROVIDERS = [
provider('drun', 'D.Run (China)', 'https://chat.d.run/v1', 'public/deepseek-v3', 131072, { apiKeyUrl: 'https://www.d.run', inputCostPerMillionUsd: 0.28, outputCostPerMillionUsd: 1.1 }),
provider('evroc', 'evroc', 'https://models.think.evroc.com/v1', 'moonshotai/Kimi-K2.6', 262144, { apiKeyUrl: 'https://docs.evroc.com/products/think/overview.html', supportsVision: true, inputCostPerMillionUsd: 1.4375, outputCostPerMillionUsd: 5.75 }),
provider('fastrouter', 'FastRouter', 'https://go.fastrouter.ai/api/v1', 'moonshotai/kimi-k2', 131072, { apiKeyUrl: 'https://fastrouter.ai/models', inputCostPerMillionUsd: 0.55, outputCostPerMillionUsd: 2.2 }),
+ provider('freebuff2api', 'Freebuff2API (Local)', 'http://127.0.0.1:8080/v1', '', 16384, { category: 'local', apiKeyUrl: 'https://github.com/Quorinex/Freebuff2API', requiresModel: true, apiKeyPlaceholder: 'Optional proxy API key' }),
provider('friendli', 'Friendli', 'https://api.friendli.ai/serverless/v1', 'google/gemma-4-31B-it', 262144, { apiKeyUrl: 'https://friendli.ai/docs/guides/serverless_endpoints/introduction', supportsVision: true, inputCostPerMillionUsd: 0.14, outputCostPerMillionUsd: 0.4 }),
provider('google-vertex', 'Google Vertex AI', 'https://{vertex_endpoint}/v1/projects/{project}/locations/{location}/endpoints/openapi', 'gemini-3.7-flash', 1048576, { category: 'cloud', apiKeyUrl: 'https://console.cloud.google.com/apis/credentials', apiKeyHeader: 'x-goog-api-key', project: '', location: 'us-central1', supportsVision: true, apiKeyPlaceholder: 'Google authorization key', suggestions: ['gemini-3.1-pro', 'gemini-3.7-flash', 'gemini-3.6-flash', 'gemini-3.5-flash'] }),
provider('google-vertex-anthropic', 'Google Vertex AI (Anthropic)', 'https://{vertex_endpoint}', 'claude-sonnet-5', 1000000, { category: 'cloud', type: 'vertex_anthropic', apiKeyUrl: 'https://console.cloud.google.com/apis/credentials', project: '', location: 'us-east5', supportsVision: true, inputCostPerMillionUsd: 2, cacheReadCostPerMillionUsd: 0.2, cacheWriteCostPerMillionUsd: 2.5, outputCostPerMillionUsd: 10, apiKeyPlaceholder: 'Google authorization key', suggestions: ['claude-opus-5', 'claude-sonnet-5', 'claude-haiku-4-5@20251001'] }),
diff --git a/test/provider-catalog-integrations.mjs b/test/provider-catalog-integrations.mjs
new file mode 100644
index 000000000..eb589b95b
--- /dev/null
+++ b/test/provider-catalog-integrations.mjs
@@ -0,0 +1,36 @@
+import { strict as assert } from 'node:assert';
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+
+const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+
+for (const browser of ['chrome', 'firefox']) {
+ const prefix = path.join(ROOT, 'src', browser, 'src');
+ const { ADDITIONAL_PROVIDER_DEFAULTS, ADDITIONAL_PROVIDER_UI } = await import(
+ pathToFileURL(path.join(prefix, 'providers', 'provider-catalog.js')).href
+ );
+
+ const ioNet = ADDITIONAL_PROVIDER_DEFAULTS['io-net'];
+ assert.equal(ioNet.type, 'openai', `${browser}: IO.NET must use the OpenAI-compatible adapter`);
+ assert.equal(ioNet.baseUrl, 'https://api.intelligence.io.solutions/api/v1', `${browser}: IO.NET endpoint changed`);
+ assert.ok(ioNet.model, `${browser}: IO.NET needs a default model`);
+
+ const synthetic = ADDITIONAL_PROVIDER_DEFAULTS.synthetic;
+ assert.equal(synthetic.type, 'openai', `${browser}: Synthetic must use the OpenAI-compatible adapter`);
+ assert.equal(synthetic.baseUrl, 'https://api.synthetic.new/openai/v1', `${browser}: Synthetic endpoint changed`);
+ assert.ok(synthetic.model, `${browser}: Synthetic needs a default model`);
+
+ const freebuff = ADDITIONAL_PROVIDER_DEFAULTS.freebuff2api;
+ assert.equal(freebuff.type, 'openai', `${browser}: Freebuff2API must use the OpenAI-compatible adapter`);
+ assert.equal(freebuff.category, 'local', `${browser}: Freebuff2API must be a local proxy card`);
+ assert.equal(freebuff.baseUrl, 'http://127.0.0.1:8080/v1', `${browser}: Freebuff2API default endpoint changed`);
+ assert.equal(freebuff.requiresModel, true, `${browser}: Freebuff2API must require a selected model`);
+ assert.equal(freebuff.requiresApiKey, undefined, `${browser}: Freebuff2API API key must remain optional`);
+ assert.equal(ADDITIONAL_PROVIDER_UI.freebuff2api.apiKeyPlaceholder, 'Optional proxy API key', `${browser}: Freebuff2API API key hint changed`);
+
+ const manager = fs.readFileSync(path.join(prefix, 'providers', 'manager.js'), 'utf8');
+ assert.match(manager, /LOCAL_MODEL_LIST_PROVIDER_IDS = \[[^\]]*'freebuff2api'/, `${browser}: Freebuff2API model discovery is not enabled`);
+}
+
+console.log('provider catalog integration tests passed');