experientiallabs /experiential
Experiential is the open source, zero markup gateway for BYOK, self-hosted and 1000+ marketplace models. It learns from your traffic to cut costs, recommend better models, and train a specialized model you own.
★ 17,142⑂ 310👁 20⑃ 1,256● 118▤ 208
+121
日增长
17,142
stars
310
forks
20
watchers
1,256
prs
118
issues
208
releases
README
Experiential
Experiential is an open source gateway and router for agent workflows:
1. Use hosted, BYOK, and local models through one OpenAI-compatible API.
2. Control which users and agents can use which models, for which use cases, and how much they can spend.
3. Turn production traffic into a custom router or model optimized for quality, speed, and cost.
!Experiential workspace usage dashboard showing model traffic, identities, and spend
🌐 Platform |
📚 Docs |
Discord
Getting Started
Start a local OpenAI-compatible gateway. On first run, the setup wizard uses the shared provider,
model, and reasoning-effort selectors, persists every selected provider connection, then shows
defaults for the public alias, identity, and $50.00 command budget before printing a one-time key:
bash
pip install experiential
exp
Choose a public alias such as opus-5, capture the issued key, and send a request:
bash
export EXP_GATEWAY_KEY=...
curl http://127.0.0.1:8000/v1/chat/completions \
-H "Authorization: Bearer $EXP_GATEWAY_KEY" \
-H 'Content-Type: application/json' \
-d '{"model":"opus-5","messages":[{"role":"user","content":"Help me"}]}'
Setup / get started with the hosted gateway
Prefer a managed gateway to running one locally? The hosted platform at
platform.experientiallabs.ai serves the same
OpenAI-compatible (and Anthropic Messages) API at https://api.experientiallabs.ai/v1.
See SETUP.md for copy-paste prompts you hand to your coding agent
(Claude Code, Cursor, Codex, and similar); the agent runs the setup for you. It
collects four prompts:
- Upload your LLM traces as telemetry: create an account instantly from your email, then pull or upload your existing LLM traces onto the platform as telemetry.
- Connect your inference provider keys (BYOK): create an account, then connect your own OpenAI, Anthropic, Gemini, Azure, Bedrock, Fireworks, or OpenRouter keys for free pass-through.
- Start calling models on the gateway: make your first /v1 call with the OpenAI and Anthropic SDKs using an xpl_ key, and optionally repoint your existing coding agents.
- Full onboarding: create an account instantly from your email, connect your keys, import your spend, then repoint every coding agent (Claude Code, Cursor, Codex, Aider, and similar) or Conductor at the gateway.
Using the API
Start the local gateway with exp (or exp run); the compiled native data plane
serves every route on loopback. From Python, load a fitted project router as an
official OpenAI client backed by its own private gateway:
python
import exp
with exp.load_router("my-project") as client:
response = client.chat.completions.create(
model="my-project",
messages=[{"role": "user", "content": "hello"}],
)
Coding Agent
exp code runs exp-code, Experiential's open-source coding and cowork
agent built on Pi. It needs Node.js 22.19 or newer and
uses your running local gateway, or the hosted gateway after exp login:
bash
exp code Top issues
#1270Minified React error #4412 comments · 2026-10-25#1275Gateway drops/hangs requests with body over ~22-24 KB (no 413)1 comments · 2026-10-26#1082Preserve distinct evaluation cases during scenario deduplication1 comments · 2026-09-23#1081Move remaining ingestion sample fixtures into common1 comments · 2026-09-23#946Gateway throttle handling: retry-and-wait with fair-share priority, failover for uncached requests, no 30 s lane suppression window1 comments · 2026-09-15#1372Tool-using SFT examples crash the concrete cookbook renderer0 comments · 2026-11-15#1371Provider and training catalog edits silently erase authored gateway routing0 comments · 2026-11-15#1326fix(docs): test-build states a $10 default warning budget instead of $500 comments · 2026-11-10
Latest release
experiential 0.7.246 v0.7.246 2026-11-15Ships 1365: gateway exits for five stuck states. These are the guardrail pool worker leak on cancel, the alias reload backoff, health registry pruning, closing requests left open by a crash during failover, and a follow-up crash reconcile pass for exclusive owners. Python only; exp-gateway-native stays 0.3.190.
News & coverage (6)
Hacker NewsShow HN: We built open OpenRouter that turns usage into a better model▲ 222 · 47 comments · 2026-08-27Marketing DiveStagwell expands experiential marketing capacity with Tinsel acquisition2023-07-24StagwellStagwell's (STGW) Constellation Network Acquires Fast-Growing Tinsel Experiential Design2023-07-18Campaign USStagwell acquires experiential design firm Tinsel2023-07-18Cornell UniversityExperiential and Engaged: Cooperative Business Management Student Project Video 42022-10-09Event MarketerHow GitHub Universe Leans on Empathy and Inclusion2019-12-23