Skip to content

Use Claude Code, Codex, VSCode, Pi, and OpenCode (and 6 other harnesses) for free (1.3B+ free tokens) from your terminal, app, IDE, or phone, and now from the browser with native browser sessions (multi-harness + multi-model) like OpenClaw (voice supported + ToS friendly)

Python

Add Experiential Labs provider (#1749)

Tanishq-10329ac495900
diff --git a/.env.example b/.env.example
index b01e20b2..d4c3d592 100644
--- a/.env.example
+++ b/.env.example
@@ -88,6 +88,12 @@ NARAROUTE_BASE_URL="https://router.bynara.id/v1"
# LIGHTNING_BASE_URL="https://lightning.ai/api/v1"
+# Experiential Labs (OpenAI-compatible Chat Completions at api.experientiallabs.ai/v1)
+# Keys look like xpl_<40 hex>; mint one at https://platform.experientiallabs.ai/settings/api-keys
+# EXPLABS_API_KEY=<your-token>
+# EXPLABS_BASE_URL="https://api.experientiallabs.ai/v1"
+
+
# Fireworks AI Config (OpenAI-compatible Chat Completions at api.fireworks.ai/inference/v1)
# FIREWORKS_API_KEY=<your-token>
@@ -201,7 +207,7 @@ OLLAMA_BASE_URL="http://localhost:11434"
# Default model and optional Claude tier overrides
# Format: provider_type/model/name
-# Valid providers: "nvidia_nim" | "openai" | "azure_openai" | "open_router" | "gemini" | "vertex" | "deepseek" | "mistral" | "mistral_codestral" | "opencode_zen" | "opencode_go" | "vercel" | "bedrock" | "huggingface" | "cohere" | "wafer" | "kimi" | "kimi_code" | "minimax" | "cerebras" | "groq" | "cline_pass" | "xai" | "qwencloud" | "qwencloud_coding" | "together" | "deepinfra" | "siliconflow" | "nebius" | "chutes" | "featherless" | "agnes" | "zenmux" | "wandb" | "sambanova" | "kilo" | "fireworks" | "novita" | "cloudflare" | "zai" | "ollama_cloud" | "lmstudio" | "llamacpp" | "ollama" | "tokenrouter" | "nararoute" | "poolside" | "llm7" | "lightning"
+# Valid providers: "nvidia_nim" | "openai" | "azure_openai" | "open_router" | "gemini" | "vertex" | "deepseek" | "mistral" | "mistral_codestral" | "opencode_zen" | "opencode_go" | "vercel" | "bedrock" | "huggingface" | "cohere" | "wafer" | "kimi" | "kimi_code" | "minimax" | "cerebras" | "groq" | "cline_pass" | "xai" | "qwencloud" | "qwencloud_coding" | "together" | "deepinfra" | "siliconflow" | "nebius" | "chutes" | "featherless" | "agnes" | "zenmux" | "wandb" | "sambanova" | "kilo" | "fireworks" | "novita" | "cloudflare" | "zai" | "ollama_cloud" | "lmstudio" | "llamacpp" | "ollama" | "tokenrouter" | "nararoute" | "poolside" | "llm7" | "lightning" | "experiential"
# MODEL_FABLE=<provider/model-id>
# MODEL_OPUS=<provider/model-id>
# MODEL_SONNET=<provider/model-id>
@@ -244,6 +250,7 @@ MODEL="nvidia_nim/nvidia/nemotron-3-super-120b-a12b"
# FCC_SMOKE_MODEL_POOLSIDE=<provider/model-id>
# FCC_SMOKE_MODEL_LLM7=<provider/model-id>
# FCC_SMOKE_MODEL_LIGHTNING=<provider/model-id>
+# FCC_SMOKE_MODEL_EXPERIENTIAL=<provider/model-id>
# FCC_SMOKE_MODEL_FIREWORKS=<provider/model-id>
# FCC_SMOKE_MODEL_NOVITA=<provider/model-id>
# FCC_SMOKE_MODEL_CLOUDFLARE=<provider/model-id>
@@ -323,6 +330,7 @@ REASONING_HAIKU=inherit
# POOLSIDE_PROXY=<http-or-socks-url>
# LLM7_PROXY=<http-or-socks-url>
# LIGHTNING_PROXY=<http-or-socks-url>
+# EXPLABS_PROXY=<http-or-socks-url>
# FIREWORKS_PROXY=<http-or-socks-url>
# NOVITA_PROXY=<http-or-socks-url>
# CLOUDFLARE_PROXY=<http-or-socks-url>
diff --git a/README.md b/README.md
index d615c9cd..75ceb70b 100644
--- a/README.md
+++ b/README.md
@@ -25,7 +25,7 @@
## What You Get
-- **52 ToS-friendly providers. 1.3B+ free tokens every month.** Use free, paid, subscription, and local models from one searchable UI without putting your account at risk. FCC follows provider terms and removes integrations if they stop being allowed.
+- **53 ToS-friendly providers. 1.3B+ free tokens every month.** Use free, paid, subscription, and local models from one searchable UI without putting your account at risk. FCC follows provider terms and removes integrations if they stop being allowed.
- **10 coding agents. One model catalog.** Run [Claude Code](https://code.claude.com/docs/en/overview), [Codex](https://github.com/openai/codex), [Pi](https://github.com/earendil-works/pi), [OpenCode](https://github.com/anomalyco/opencode), [Cline](https://github.com/cline/cline), [Hermes](https://github.com/NousResearch/hermes-agent), [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness), [Grok Build](https://github.com/xai-org/grok-build), [Muse Code](https://research.meta.ai/blog/introducing-muse-code-and-muse-spark-1-2/), or [Aider](https://aider.chat/) with your FCC models.
- **Keep coding through provider outages.** After retries are exhausted, FCC automatically tries your next configured model without making you restart the turn—across every client.
- **Up to 90% fewer terminal-output tokens.** Optional [RTK](https://github.com/rtk-ai/rtk) filters common command output, while five FCC optimizations handle quota probes, command-prefix detection, titles, suggestions, and filepaths without calling a provider.
@@ -240,6 +240,7 @@ from more than one provider before succeeding.
| [LLM7.io](https://dash.llm7.io/) | `LLM7_API_KEY` | `llm7/default` |
| [Scaleway](https://console.scaleway.com/iam/api-keys) | `SCW_SECRET_KEY` | `scaleway/deepseek/deepseek-v4-flash` |
| [Lightning AI](https://lightning.ai/) | `LIGHTNING_API_KEY` | `lightning/lightning-ai/Qwen3.8-27B` |
+| [Experiential Labs](https://platform.experientiallabs.ai/) | `EXPLABS_API_KEY` | `experiential/union-alpha` |
| [Ollama Cloud](https://ollama.com/settings/keys) | `OLLAMA_API_KEY` | `ollama_cloud/qwen3-coder:480b` |
| [LM Studio](https://lmstudio.ai/) | `LM_STUDIO_BASE_URL` | `lmstudio/<model-id>` |
| [llama.cpp](https://github.com/ggml-org/llama.cpp) | `LLAMACPP_BASE_URL` | `llamacpp/<model-id>` |
diff --git a/pyproject.toml b/pyproject.toml
index f17d97ae..a0e7b255 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
[project]
name = "free-claude-code"
-version = "6.2.38"
+version = "6.2.39"
description = "Local proxy connecting coding agents to OpenAI-compatible AI providers"
readme = "README.md"
requires-python = ">=3.14.0"
diff --git a/smoke/lib/config.py b/smoke/lib/config.py
index 11c5aa69..448c154c 100644
--- a/smoke/lib/config.py
+++ b/smoke/lib/config.py
@@ -94,6 +94,7 @@ PROVIDER_SMOKE_DEFAULT_MODELS: dict[str, str] = {
"poolside": "poolside/poolside/laguna-s-2.1",
"llm7": "llm7/default",
"lightning": "lightning/lightning-ai/Qwen3.8-27B",
+ "experiential": "experiential/union-alpha",
"agnes": "agnes/agnes-2.0-flash",
"zenmux": "zenmux/deepseek/deepseek-v4-flash-free",
"wandb": "wandb/openai/gpt-oss-20b",
diff --git a/src/free_claude_code/api/admin_static/providers/SOURCES.md b/src/free_claude_code/api/admin_static/providers/SOURCES.md
index 67a13d18..88e08b52 100644
--- a/src/free_claude_code/api/admin_static/providers/SOURCES.md
+++ b/src/free_claude_code/api/admin_static/providers/SOURCES.md
@@ -17,6 +17,7 @@ The LLaMA.cpp icon comes from the upstream llama.cpp repository; its MIT license
| `cohere-color.svg` | https://unpkg.com/@lobehub/[email protected]/icons/cohere-color.svg |
| `deepinfra-color.svg` | https://unpkg.com/@lobehub/[email protected]/icons/deepinfra-color.svg |
| `deepseek-color.svg` | https://unpkg.com/@lobehub/[email protected]/icons/deepseek-color.svg |
+| `experiential.svg` | https://www.experientiallabs.ai/icon.svg?d749d3cd48f6539d |
| `featherless-color.svg` | https://unpkg.com/@lobehub/[email protected]/icons/featherless-color.svg |
| `fireworks-color.svg` | https://unpkg.com/@lobehub/[email protected]/icons/fireworks-color.svg |
| `gemini-color.svg` | https://unpkg.com/@lobehub/[email protected]/icons/gemini-color.svg |
diff --git a/src/free_claude_code/api/admin_static/providers/experiential.svg b/src/free_claude_code/api/admin_static/providers/experiential.svg
new file mode 100644
index 00000000..3e6a997a
--- /dev/null
+++ b/src/free_claude_code/api/admin_static/providers/experiential.svg
@@ -0,0 +1,9 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32">
+ <rect width="32" height="32" fill="#ededed"/>
+ <g transform="translate(1.829,1.868) scale(0.012941)">
+ <g transform="translate(0,2200) scale(0.1,-0.1)" fill="#0a0a0a" stroke="none">
+ <path d="M17475 19110 c-294 -50 -396 -73 -755 -168 -376 -99 -448 -122 -767 -240 -932 -347 -1693 -776 -2412 -1361 -217 -176 -338 -285 -574 -515 -725 -708 -1207 -1383 -1618 -2267 -130 -280 -169 -376 -284 -706 -201 -571 -292 -920 -391 -1486 -71 -409 -76 -452 -105 -817 -28 -362 -29 -406 -23 -740 8 -504 47 -869 144 -1373 98 -506 198 -867 365 -1319 172 -466 321 -774 598 -1238 289 -484 512 -788 885 -1205 232 -260 325 -354 577 -588 250 -232 353 -320 620 -525 392 -302 656 -474 1082 -705 277 -149 360 -188 715 -336 571 -238 861 -330 1378 -437 206 -42 398 -77 425 -77 93 -1 167 40 216 120 33 54 31 134 -7 202 -65 120 -35 103 -746 411 -356 153 -662 287 -680 296 -18 9 -212 118 -431 241 -570 321 -852 510 -1312 877 l-360 287 -400 416 -400 416 -282 398 c-273 386 -287 408 -447 706 -111 207 -195 379 -256 524 -81 196 -102 259 -211 655 -116 421 -123 449 -156 689 -31 225 -35 279 -40 545 -5 288 -4 302 31 620 34 304 59 464 76 483 3 4 189 50 411 101 547 126 725 186 1213 403 330 147 403 184 700 355 309 179 350 206 621 411 282 213 627 510 801 689 243 250 448 489 710 829 240 312 310 410 485 689 290 458 482 826 675 1287 128 308 160 396 274 764 l129 415 96 495 97 494 44 530 c39 463 43 539 33 605 -13 87 -25 113 -72 158 -75 73 -210 71 -672 -8z m-65 -767 c0 -134 -39 -408 -111 -778 -78 -404 -81 -416 -203 -805 -161 -515 -296 -846 -530 -1301 -148 -286 -185 -349 -407 -685 -203 -306 -286 -420 -481 -664 -282 -352 -537 -628 -827 -897 -191 -177 -258 -231 -639 -511 -417 -306 -431 -315 -693 -458 -379 -206 -760 -368 -1081 -458 -127 -36 -233 -64 -235 -62 -2 2 41 116 96 253 97 243 106 260 388 756 l290 508 382 513 382 513 481 514 c264 283 487 524 495 537 22 32 20 118 -4 150 -38 51 -68 66 -135 66 -35 0 -74 -6 -87 -13 -13 -7 -239 -191 -503 -409 -459 -378 -491 -407 -750 -671 -149 -152 -363 -384 -477 -516 -173 -201 -254 -308 -502 -660 -270 -384 -309 -444 -446 -695 -83 -151 -160 -293 -171 -315 -12 -22 -21 -34 -22 -27 -1 52 72 420 125 628 93 361 309 955 484 1334 255 550 568 1056 964 1558 278 352 524 615 835 890 215 190 263 227 645 491 345 239 454 308 669 427 540 299 1180 564 1773 735 149 42 276 78 283 78 7 1 12 -11 12 -26z"/>
+ <path d="M3907 18396 c-54 -15 -97 -51 -134 -114 -50 -85 -28 -185 59 -269 23 -22 231 -126 673 -336 599 -283 658 -314 915 -470 185 -112 383 -244 606 -404 l332 -238 442 -407 442 -407 327 -395 c406 -491 601 -766 845 -1193 157 -275 175 -312 382 -793 l217 -505 134 -500 c133 -496 134 -502 174 -790 56 -407 63 -513 62 -995 0 -548 -22 -789 -114 -1270 -122 -640 -286 -1153 -547 -1704 -126 -266 -160 -326 -392 -701 -306 -495 -441 -677 -774 -1043 -215 -236 -258 -277 -611 -586 -351 -306 -405 -349 -693 -551 -612 -431 -1292 -799 -2024 -1096 -205 -83 -384 -157 -398 -164 -28 -15 -111 -100 -127 -131 -20 -37 -23 -99 -9 -159 12 -51 22 -67 63 -104 102 -93 133 -95 463 -31 377 74 933 237 1302 384 584 232 1065 498 1611 893 266 192 346 257 585 472 556 499 960 957 1365 1546 175 254 243 364 379 610 428 779 718 1619 843 2441 24 164 49 326 55 359 5 33 18 213 27 400 33 661 -9 1220 -142 1887 -58 288 -84 393 -196 773 -122 416 -137 459 -275 795 -211 513 -383 845 -698 1349 -429 686 -787 1124 -1348 1650 -253 236 -337 308 -583 495 -546 414 -1013 676 -1640 919 -301 117 -344 130 -725 230 -390 103 -698 168 -784 166 -22 0 -63 -6 -89 -13z"/>
+ </g>
+ </g>
+</svg>
diff --git a/src/free_claude_code/config/admin/provider_manifest.py b/src/free_claude_code/config/admin/provider_manifest.py
index f065094a..c8133a64 100644
--- a/src/free_claude_code/config/admin/provider_manifest.py
+++ b/src/free_claude_code/config/admin/provider_manifest.py
@@ -303,6 +303,20 @@ _PROVIDER_FIELD_OVERRIDES: dict[str, ProviderFieldOverride] = {
"Create one in [W&B User Settings](https://wandb.ai/settings)."
),
},
+ "EXPLABS_API_KEY": {
+ "label": "Experiential Labs API Key",
+ "description": (
+ "Experiential Labs OpenAI-compatible gateway API key for "
+ "api.experientiallabs.ai/v1. Keys look like xpl_ followed by 40 "
+ "hex characters; mint one at platform.experientiallabs.ai/settings/api-keys."
+ ),
+ },
+ "EXPLABS_BASE_URL": {
+ "description": (
+ "Experiential Labs OpenAI-compatible Chat Completions base URL. "
+ "Defaults to https://api.experientiallabs.ai/v1."
+ ),
+ },
}
diff --git a/src/free_claude_code/config/provider_catalog.py b/src/free_claude_code/config/provider_catalog.py
index 393bb58e..65ae3342 100644
--- a/src/free_claude_code/config/provider_catalog.py
+++ b/src/free_claude_code/config/provider_catalog.py
@@ -84,6 +84,8 @@ POOLSIDE_DEFAULT_BASE = "https://inference.poolside.ai/v1"
LLM7_DEFAULT_BASE = "https://api.llm7.io/v1"
# Lightning AI Model APIs OpenAI-compatible Chat Completions gateway.
LIGHTNING_DEFAULT_BASE = "https://lightning.ai/api/v1"
+# Experiential Labs OpenAI-compatible Chat Completions gateway.
+EXPERIENTIAL_DEFAULT_BASE = "https://api.experientiallabs.ai/v1"
# Agnes AI OpenAI-compatible Chat Completions API.
AGNES_DEFAULT_BASE = "https://apihub.agnes-ai.com/v1"
# ZenMux OpenAI-compatible Chat Completions gateway.
@@ -666,6 +668,18 @@ PROVIDER_CATALOG: dict[str, ProviderDescriptor] = {
base_url_attr="lightning_base_url",
proxy_attr="lightning_proxy",
),
+ "experiential": ProviderDescriptor(
+ provider_id="experiential",
+ display_name="Experiential Labs",
+ website_url="https://www.experientiallabs.ai/",
+ logo_filename="experiential.svg",
+ credential_env="EXPLABS_API_KEY",
+ credential_url="https://platform.experientiallabs.ai/settings/api-keys",
+ credential_attr="experiential_api_key",
+ default_base_url=EXPERIENTIAL_DEFAULT_BASE,
+ base_url_attr="experiential_base_url",
+ proxy_attr="experiential_proxy",
+ ),
"ollama_cloud": ProviderDescriptor(
provider_id="ollama_cloud",
display_name="Ollama Cloud",
diff --git a/src/free_claude_code/config/settings.py b/src/free_claude_code/config/settings.py
index d7d176f7..bb694f3d 100644
--- a/src/free_claude_code/config/settings.py
+++ b/src/free_claude_code/config/settings.py
@@ -17,6 +17,7 @@ from .model_refs import parse_model_fallbacks
from .nim import NimSettings
from .provider_catalog import (
BEDROCK_DEFAULT_BASE,
+ EXPERIENTIAL_DEFAULT_BASE,
LIGHTNING_DEFAULT_BASE,
NARAROUTE_DEFAULT_BASE,
SUPPORTED_PROVIDER_IDS,
@@ -200,6 +201,15 @@ class Settings(BaseModel):
validation_alias="LIGHTNING_BASE_URL",
)
+ # ==================== Experiential Labs (OpenAI-compatible) ====================
+ experiential_api_key: OptionalNonEmptyString = Field(
+ default=None, validation_alias="EXPLABS_API_KEY"
+ )
+ experiential_base_url: NonEmptyString = Field(
+ default=EXPERIENTIAL_DEFAULT_BASE,
+ validation_alias="EXPLABS_BASE_URL",
+ )
+
# ==================== Fireworks AI Config ====================
fireworks_api_key: OptionalNonEmptyString = Field(
default=None, validation_alias="FIREWORKS_API_KEY"
@@ -497,6 +507,9 @@ class Settings(BaseModel):
lightning_proxy: OptionalNonEmptyString = Field(
default=None, validation_alias="LIGHTNING_PROXY"
)
+ experiential_proxy: OptionalNonEmptyString = Field(
+ default=None, validation_alias="EXPLABS_PROXY"
+ )
fireworks_proxy: OptionalNonEmptyString = Field(
default=None, validation_alias="FIREWORKS_PROXY"
)
diff --git a/src/free_claude_code/providers/credential_validation.py b/src/free_claude_code/providers/credential_validation.py
index e4e1621f..ac9fe823 100644
--- a/src/free_claude_code/providers/credential_validation.py
+++ b/src/free_claude_code/providers/credential_validation.py
@@ -74,6 +74,7 @@ _MODELS = _list_field("data")
# https://docs.wafer.ai/serverless/usage-api
# https://platform.kimi.ai/docs/api/errors
# https://router.bynara.id/id/docs
+# https://platform.experientiallabs.ai/docs/authentication
_PROBES = (
_Probe(
"open_router",
@@ -143,6 +144,7 @@ _PROBES = (
_AUTH_401,
),
_Probe("nararoute", "/models", _MODELS, _AUTH_401),
+ _Probe("experiential", "/models", _MODELS, _AUTH_401),
# Positive evidence only: these errors can also reflect permissions, budget,
# token type, or an undocumented response contract. Never reject on failure.
# https://docs.deepinfra.com/api-reference/account/me
diff --git a/src/free_claude_code/providers/openai_chat/profiles.py b/src/free_claude_code/providers/openai_chat/profiles.py
index f4f5cf84..d6ad63df 100644
--- a/src/free_claude_code/providers/openai_chat/profiles.py
+++ b/src/free_claude_code/providers/openai_chat/profiles.py
@@ -711,6 +711,18 @@ OPENAI_CHAT_PROFILES: dict[str, OpenAIChatProfile] = {
input_modalities_path=("architecture", "input_modalities"),
),
),
+ "experiential": OpenAIChatProfile(
+ _policy(
+ "EXPERIENTIAL",
+ ReasoningReplayMode.REASONING_CONTENT,
+ default_max_tokens=ANTHROPIC_DEFAULT_MAX_OUTPUT_TOKENS,
+ ),
+ NamedEffortReasoning(
+ _LOW_MEDIUM_HIGH,
+ enabled_value="medium",
+ ),
+ model_listing=OpenAIModelListing(path="/models"),
+ ),
"ollama_cloud": OpenAIChatProfile(
_policy(
"OLLAMA_CLOUD",
diff --git a/tests/contracts/test_provider_catalog_order.py b/tests/contracts/test_provider_catalog_order.py
index 7d7cde27..ccd66bf1 100644
--- a/tests/contracts/test_provider_catalog_order.py
+++ b/tests/contracts/test_provider_catalog_order.py
@@ -54,6 +54,7 @@ _EXPECTED_PROVIDER_ORDER: tuple[str, ...] = (
"llm7",
"scaleway",
"lightning",
+ "experiential",
"ollama_cloud",
"lmstudio",
"llamacpp",
diff --git a/tests/contracts/test_smoke_config.py b/tests/contracts/test_smoke_config.py
index 21bc2caf..4a49fb76 100644
--- a/tests/contracts/test_smoke_config.py
+++ b/tests/contracts/test_smoke_config.py
@@ -69,6 +69,7 @@ def _settings(**overrides):
"poolside_api_key": "",
"llm7_api_key": "",
"lightning_api_key": "",
+ "experiential_api_key": "",
"fireworks_api_key": "",
"novita_api_key": "",
"cloudflare_api_token": "",
@@ -284,6 +285,58 @@ def test_lightning_is_not_enabled_without_explicit_credential(monkeypatch) -> No
assert config.provider_smoke_models() == []
+def test_experiential_provider_configuration_uses_documented_free_model(
+ monkeypatch,
+) -> None:
+ monkeypatch.delenv("FCC_SMOKE_MODEL_EXPERIENTIAL", raising=False)
+ config = _smoke_config(
+ settings=_settings(
+ model="ollama/llama3.1",
+ ollama_base_url="",
+ experiential_api_key="experiential-key",
+ )
+ )
+
+ assert config.has_provider_configuration("experiential")
+ models = config.provider_smoke_models()
+ assert [model.provider for model in models] == ["experiential"]
+ assert models[0].full_model == "experiential/union-alpha"
+ assert models[0].source == "provider_default"
+
+
+def test_experiential_smoke_override_accepts_model_with_or_without_prefix(
+ monkeypatch,
+) -> None:
+ settings = _settings(
+ model="ollama/llama3.1",
+ ollama_base_url="",
+ experiential_api_key="experiential-key",
+ )
+ for override in (
+ "deepseek-v4-flash",
+ "experiential/deepseek-v4-flash",
+ ):
+ monkeypatch.setenv("FCC_SMOKE_MODEL_EXPERIENTIAL", override)
+ models = _smoke_config(settings=settings).provider_smoke_models()
+
+ assert [model.provider for model in models] == ["experiential"]
+ assert models[0].full_model == "experiential/deepseek-v4-flash"
+ assert models[0].source == "FCC_SMOKE_MODEL_EXPERIENTIAL"
+
+
+def test_experiential_is_not_enabled_without_explicit_credential(
+ monkeypatch,
+) -> None:
+ monkeypatch.delenv("FCC_SMOKE_MODEL_EXPERIENTIAL", raising=False)
+ config = _smoke_config(
+ provider_matrix=frozenset({"experiential"}),
+ settings=_settings(ollama_base_url="", experiential_api_key=""),
+ )
+
+ assert not config.has_provider_configuration("experiential")
+ assert config.provider_smoke_models() == []
+
+
def test_xai_provider_smoke_uses_current_grok_model(monkeypatch) -> None:
monkeypatch.delenv("FCC_SMOKE_MODEL_XAI", raising=False)
config = _smoke_config(
diff --git a/tests/providers/test_credential_validation.py b/tests/providers/test_credential_validation.py
index 06e2f8e4..356746b2 100644
--- a/tests/providers/test_credential_validation.py
+++ b/tests/providers/test_credential_validation.py
@@ -61,6 +61,7 @@ CASES = [
401,
),
("nararoute", "https://router.bynara.id/v1/models", {"data": []}, 401),
+ ("experiential", "https://api.experientiallabs.ai/v1/models", {"data": []}, 401),
(
"deepinfra",
"https://api.deepinfra.com/v1/me",
diff --git a/tests/providers/test_experiential.py b/tests/providers/test_experiential.py
new file mode 100644
index 00000000..f192276a
--- /dev/null
+++ b/tests/providers/test_experiential.py
@@ -0,0 +1,236 @@
+"""Tests for the Experiential Labs OpenAI-chat provider profile."""
+
+from unittest.mock import AsyncMock
+
+import httpx2
+import pytest
+from openai import AsyncOpenAI
+
+from free_claude_code.application.model_metadata import ProviderModelInfo
+from free_claude_code.config.constants import ANTHROPIC_DEFAULT_MAX_OUTPUT_TOKENS
+from free_claude_code.config.provider_catalog import EXPERIENTIAL_DEFAULT_BASE
+from free_claude_code.core.anthropic.models import MessagesRequest
+from free_claude_code.core.json_types import JsonObject, JsonValue
+from free_claude_code.core.reasoning import ReasoningEffort, ReasoningPolicy
+from free_claude_code.providers.model_listing import ModelListResponseError
+from free_claude_code.providers.openai_chat import OpenAIChatProvider
+from free_claude_code.providers.openai_chat.profiles import OPENAI_CHAT_PROFILES
+from tests.providers.support import (
+ immediate_admission,
+ make_provider_config,
+ profiled_provider,
+ reasoning_for,
+)
+
+_MODEL = "union-alpha"
+
+
+def experiential_provider() -> OpenAIChatProvider:
+ return profiled_provider(
+ "experiential",
+ make_provider_config(
+ api_key="test-experiential-key",
+ base_url=EXPERIENTIAL_DEFAULT_BASE,
+ rate_limit=10,
+ rate_window=60,
+ ),
+ admission=immediate_admission(provider_name="experiential", max_attempts=1),
+ )
+
+
+def _request(**overrides: JsonValue) -> MessagesRequest:
+ payload: JsonObject = {
+ "model": _MODEL,
+ "messages": [{"role": "user", "content": "Inspect the file."}],
+ "tools": [
+ {
+ "name": "read_file",
+ "description": "Read a file",
+ "input_schema": {
+ "type": "object",
+ "properties": {"path": {"type": "string"}},
+ "required": ["path"],
+ },
+ }
+ ],
+ }
+ payload.update(overrides)
+ return MessagesRequest.model_validate(payload)
+
+
+def test_constructs_standard_openai_chat_provider(
+ experiential_provider: OpenAIChatProvider,
+) -> None:
+ assert isinstance(experiential_provider, OpenAIChatProvider)
+ assert experiential_provider._provider_name == "EXPERIENTIAL"
+ assert experiential_provider._api_key == "test-experiential-key"
+ assert experiential_provider._base_url == EXPERIENTIAL_DEFAULT_BASE
+
+
+ "reasoning",
+ [ReasoningPolicy.provider_default(), ReasoningPolicy.off()],
+)
+def test_default_and_off_reasoning_omit_effort_and_keep_standard_fields(
+ experiential_provider: OpenAIChatProvider,
+ reasoning: ReasoningPolicy,
+) -> None:
+ body = experiential_provider._chat._build_request_body(
+ _request(), reasoning=reasoning
+ )
+
+ assert body["max_tokens"] == ANTHROPIC_DEFAULT_MAX_OUTPUT_TOKENS
+ assert body["model"] == _MODEL
+ assert body["tools"][0]["function"]["name"] == "read_file"
+ assert "reasoning" not in body
+ assert "reasoning_effort" not in body
+ assert "thinking" not in body
+ assert "extra_body" not in body
+
+
+ ("reasoning", "expected"),
+ (
+ (ReasoningPolicy.on(), "medium"),
+ (ReasoningPolicy.on(effort=ReasoningEffort.MINIMAL), "low"),
+ (ReasoningPolicy.on(effort=ReasoningEffort.LOW), "low"),
+ (ReasoningPolicy.on(effort=ReasoningEffort.MEDIUM), "medium"),
+ (ReasoningPolicy.on(effort=ReasoningEffort.HIGH), "high"),
+ (ReasoningPolicy.on(effort=ReasoningEffort.XHIGH), "high"),
+ (ReasoningPolicy.on(effort=ReasoningEffort.MAX), "high"),
+ ),
+)
+def test_reasoning_maps_efforts_onto_documented_vocabulary(
+ experiential_provider: OpenAIChatProvider,
+ reasoning: ReasoningPolicy,
+ expected: str,
+) -> None:
+ body = experiential_provider._chat._build_request_body(
+ _request(), reasoning=reasoning
+ )
+
+ assert body["reasoning_effort"] == expected
+
+
+def test_replays_reasoning_content_with_tool_history(
+ experiential_provider: OpenAIChatProvider,
+) -> None:
+ request = _request(
+ messages=[
+ {"role": "user", "content": "Inspect the file."},
+ {
+ "role": "assistant",
+ "content": [
+ {"type": "thinking", "thinking": "Read it first."},
+ {"type": "text", "text": "I will inspect it."},
+ {
+ "type": "tool_use",
+ "id": "toolu_1",
+ "name": "read_file",
+ "input": {"path": "example.py"},
+ },
+ ],
+ },
+ {
+ "role": "user",
+ "content": [
+ {
+ "type": "tool_result",
+ "tool_use_id": "toolu_1",
+ "content": "print('hello')",
+ }
+ ],
+ },
+ ]
+ )
+
+ body = experiential_provider._chat._build_request_body(
+ request,
+ reasoning=reasoning_for(request),
+ )
+
+ assert body["messages"][1] == {
+ "role": "assistant",
+ "content": "I will inspect it.",
+ "reasoning_content": "Read it first.",
+ "tool_calls": [
+ {
+ "id": "toolu_1",
+ "type": "function",
+ "function": {
+ "name": "read_file",
+ "arguments": '{"path": "example.py"}',
+ },
+ }
+ ],
+ }
+ assert body["messages"][2] == {
+ "role": "tool",
+ "tool_call_id": "toolu_1",
+ "content": "print('hello')",
+ }
+
+
+async def test_model_catalog_returns_bare_ids(
+ experiential_provider: OpenAIChatProvider,
+) -> None:
+ experiential_provider._client.get = AsyncMock(
+ return_value={"data": [{"id": "dots-3-note-preview-free"}, {"id": _MODEL}]}
+ )
+
+ assert await experiential_provider.list_model_infos() == frozenset(
+ {ProviderModelInfo("dots-3-note-preview-free"), ProviderModelInfo(_MODEL)}
+ )
+
+
+async def test_model_catalog_rejects_missing_id(
+ experiential_provider: OpenAIChatProvider,
+) -> None:
+ experiential_provider._client.get = AsyncMock(return_value={"data": [{}]})
+
+ with pytest.raises(ModelListResponseError, match="include id"):
+ await experiential_provider.list_model_infos()
+
+
+async def test_model_catalog_rejects_empty_catalog(
+ experiential_provider: OpenAIChatProvider,
+) -> None:
+ experiential_provider._client.get = AsyncMock(return_value={"data": []})
+
+ with pytest.raises(ModelListResponseError, match="did not include any model ids"):
+ await experiential_provider.list_model_infos()
+
+
+async def test_model_catalog_uses_documented_url_and_bearer_auth() -> None:
+ requests: list[httpx2.Request] = []
+
+ def handler(request: httpx2.Request) -> httpx2.Response:
+ requests.append(request)
+ return httpx2.Response(200, json={"data": [{"id": _MODEL}]})
+
+ async with AsyncOpenAI(
+ api_key="wire-experiential-key",
+ base_url=EXPERIENTIAL_DEFAULT_BASE,
+ max_retries=0,
+ http_client=httpx2.AsyncClient(transport=httpx2.MockTransport(handler)),
+ ) as client:
+ experiential_provider = OpenAIChatProvider(
+ make_provider_config(
+ api_key="wire-experiential-key",
+ base_url=EXPERIENTIAL_DEFAULT_BASE,
+ ),
+ profile=OPENAI_CHAT_PROFILES["experiential"],
+ admission=immediate_admission(provider_name="experiential"),
+ client=client,
+ )
+ model_infos = await experiential_provider.list_model_infos()
+
+ assert model_infos == frozenset({ProviderModelInfo(_MODEL)})
+ assert len(requests) == 1
+ assert str(requests[0].url) == "https://api.experientiallabs.ai/v1/models"
+ assert requests[0].headers["authorization"] == "Bearer wire-experiential-key"
diff --git a/tests/providers/test_provider_runtime.py b/tests/providers/test_provider_runtime.py
index a9597861..11db24d0 100644
--- a/tests/providers/test_provider_runtime.py
+++ b/tests/providers/test_provider_runtime.py
@@ -18,6 +18,7 @@ from free_claude_code.config.provider_catalog import (
CLINE_DEFAULT_BASE,
COHERE_DEFAULT_BASE,
DEEPINFRA_DEFAULT_BASE,
+ EXPERIENTIAL_DEFAULT_BASE,
FEATHERLESS_DEFAULT_BASE,
HUGGINGFACE_DEFAULT_BASE,
KIMI_CODE_DEFAULT_BASE,
@@ -116,6 +117,8 @@ def _make_settings(**overrides):
mock.llm7_api_key = "test_llm7_key"
mock.lightning_api_key = "test_lightning_key"
mock.lightning_base_url = LIGHTNING_DEFAULT_BASE
+ mock.experiential_api_key = "test_experiential_key"
+ mock.experiential_base_url = EXPERIENTIAL_DEFAULT_BASE
mock.nvidia_nim_proxy = None
mock.open_router_proxy = None
mock.lmstudio_proxy = None
@@ -163,6 +166,7 @@ def _make_settings(**overrides):
mock.poolside_proxy = None
mock.llm7_proxy = None
mock.lightning_proxy = None
+ mock.experiential_proxy = None
mock.kilo_api_key = "test_kilo_key"
mock.kilo_proxy = None
mock.openai_proxy = None
@@ -295,6 +299,35 @@ async def test_llm7_provider_config_uses_key_base_and_proxy() -> None:
assert isinstance(provider, OpenAIChatProvider)
+async def test_experiential_provider_config_uses_key_base_and_proxy() -> None:
+ descriptor = PROVIDER_CATALOG["experiential"]
+ settings = _make_settings(
+ experiential_api_key="experiential-token",
+ experiential_base_url="https://custom.experientiallabs.example/v1",
+ experiential_proxy="http://proxy.test:8080",
+ )
+
+ config = build_provider_config(descriptor, settings)
+ with patch("free_claude_code.providers.openai_chat.client.AsyncOpenAI"):
+ provider = await create_provider("experiential", settings)
+
+ assert descriptor.display_name == "Experiential Labs"
+ assert descriptor.credential_env == "EXPLABS_API_KEY"
+ assert descriptor.credential_attr == "experiential_api_key"
+ assert (
+ descriptor.credential_url
+ == "https://platform.experientiallabs.ai/settings/api-keys"
+ )
+ assert descriptor.default_base_url == EXPERIENTIAL_DEFAULT_BASE
+ assert descriptor.base_url_attr == "experiential_base_url"
+ assert descriptor.proxy_attr == "experiential_proxy"
+ assert config.api_key == "experiential-token"
+ assert config.base_url == "https://custom.experientiallabs.example/v1"
+ assert config.proxy == "http://proxy.test:8080"
+ assert isinstance(provider, OpenAIChatProvider)
+
+
@pytest.mark.asyncio
async def test_xai_provider_config_uses_key_base_and_proxy() -> None:
descriptor = PROVIDER_CATALOG["xai"]
@@ -932,6 +965,7 @@ async def test_create_provider_instantiates_each_builtin():
"poolside": OpenAIChatProvider,
"llm7": OpenAIChatProvider,
"lightning": OpenAIChatProvider,
+ "experiential": OpenAIChatProvider,
"opencode_go": OpenCodeProvider,
"vercel": OpenAIChatProvider,
"bedrock": OpenAIChatProvider,
diff --git a/uv.lock b/uv.lock
index c2669028..48014ecf 100644
--- a/uv.lock
+++ b/uv.lock
@@ -599,7 +599,7 @@ wheels = [
[[package]]
name = "free-claude-code"
-version = "6.2.38"
+version = "6.2.39"
source = { editable = "." }
dependencies = [
{ name = "aiohttp" },